PJR-YWPH register の todo 用 plan に関連文書の grade finding を展開する
1. 概要
PJR-XKKS で grade の結果と finding は成果物の本文コメントから execution/grade/results/<doc-id>.yaml のサイドカーへ移った。agent への finding 提示は plan 生成時の展開(_GRADE_FINDINGS_)に一本化したが、展開が入っているのは fully-guided と maintenance 系・bootstrap の exec テンプレート 6 本だけで、register の todo 用 plan(xep-register-template)にはない。
PJR-EQDB(Kata の finding 解消)の再周回では、オーケストレーターが個票に対象 Kata と finding 件数を転記して補った。result には「個票にて grade 指摘の内容を確認し」とあり、サイドカーを直接読んだ痕跡がなかった。register 項目で Kata や成果物の finding 解消を扱う場合に、同じ手当てを毎回人手で行うのは無駄である。
1.1. 決定事項
- register の todo 用 plan 生成で、個票の「関連ドキュメント」に wikilink された文書のうちサイドカーを持つものについて、
_GRADE_FINDINGS_と同じ形式(severity / rule / line / anchor / message、id は渡さない)で finding を plan 本文へ展開する。 - 展開する文書数と finding 数に上限を設け(例: 文書 10 件、finding 各 20 件)、超過分は件数だけを示してサイドカーのパスを案内する。plan の遅延ロード性(PJR-JSWE)を保つ。
- サイドカーがない、または finding が 0 件の文書は「finding なし」として 1 行で示す。
2. 完了条件
exec plan --register/exec run --registerが生成する plan に、関連ドキュメントの finding が上記の形式と上限で展開されている。- 展開の有無・上限・サイドカー未存在の扱いを単体テストで検証している。
xep-register-templateとregister-operation-guideに展開の仕様が記載されている。npm run checkが通過している。
3. 作業内容
| No | 作業 | 担当 | 状態 | メモ |
|---|---|---|---|---|
| 1 | 個票の関連ドキュメントからサイドカーを解決し、上限付きで finding を展開する処理を exec-plans に追加する | DEV | done | codex-expert-executor / gemma-reporter / worktree |
| 2 | xep-register-template に展開位置と扱いの指示を追加し、テストと guide を更新する | DEV | done | 作業 1 と同一タスク |
4. 対応結果
src/exec-plans.ts に registerGradeFindingsText 関数を追加し、個票の関連ドキュメントに記述された文書のサイドカーから grade finding を展開する処理を実装しました。src/exec-register.ts からこの関数を呼び出し、docs/ja/specdojo/exec-templates/xep-register-template.md に展開結果が差し込まれるようにしました。テストは tests/src/exec-plans-grade-findings.test.ts で検証し、docs/ja/specdojo/guides/register-operation-guide.md にも展開の仕様を記載しました。
5. 関連ドキュメント
- prj-0001:pjr-xkks-grade-sidecar
- prj-0001:pjr-eqdb-kata-cdfd-stsd-rulebook-findings
- prj-0001:pjr-jswe-agent-workflow-plan-vs-skills
src/exec-plans.tsdocs/ja/specdojo/exec-templates/xep-register-template.md