Plan ファイルを Issue 化前に監査し、必須セクションの充足と影響範囲の網羅をチェックする。監査は会話を持たない plan-reviewer-agent に任せ、会話との突き合わせと Plan の修正をここで行う。「check-plan」「plan をチェック」と指示されたとき。
Install
npx skillscat add kasiopeiya/claude-dev-template/check-plan Install via the SkillsCat registry.
SKILL.md
Check Plan
Plan ファイルを Issue 化(/to-issues)の前 に監査する。通常は /to-plan から自動で呼ばれるが、単体でも実行できる。
監査の本体は `plan-reviewer-agent` が行う。Plan を書いたセッションが自分で点検すると、書かれていない前提を会話の記憶で補ってしまい、欠落に気づけないからである。判定の観点は agent 定義が正典であり、ここには書き写さない。
このスキルが担うのは、会話を見ないとできないことだけである。
- 会話と Plan の突き合わせ
- Plan の修正とユーザーへの確認
1. 対象 Plan の特定
上から順に見て、最初に当たったものを対象にする。
- 引数でパスが渡されたらそれを使う。slug なら
~/.claude/plans/<slug>.md、無ければ~/.claude/plans/*-<slug>.mdを探す。 - この会話で
/to-planまたは Plan モードが書き出したファイル。 - Plan が会話上のテキストにしか無ければ、先に
/to-planでファイルにする(agent はファイルしか読めない)。 - どれも無ければユーザーに確認する。
~/.claude/plans/の最新ファイルは候補として示すだけにする(Plan モードが書き出した別件の Plan が混ざっているため)。
2. plan-reviewer-agent を起動する
plan-reviewer-agent を Task で起動する。渡すのは Plan ファイルの絶対パス(~ を展開したもの)だけにする。会話の要約・作業の経緯・「ここを見てほしい」といった注文は渡さない。渡した時点で agent は書き手の前提を共有し、切り離した意味が消える。
起動したら結果を待たずに手順3を進める。
3. 会話と Plan を突き合わせる
agent は会話を見られないので、次の転記漏れはここでしか見つからない。
- grill-me で確定した仕様:決定事項・判断の根拠・却下した代替案とその理由が、Plan の「grill-me で確定した仕様」に書かれているか
- Not-now リスト:全行が「やらないこと」欄に、トリガーと一緒に転記されているか
- Plan モードでの調査結果:判断の前提にした事実が Plan に残っているか
4. 統合して Plan を修正する
agent の表に、手順3の3項目を1行ずつ足す。会話に該当する内容が無い項目は N/A とする。
合否・再監査回数の規定は ai-review-gate-policy に従う。
- 違反があれば、重大度にかかわらずすべてPlan ファイルを修正する(ai-review-gate-policy「残してよい例外」に当たらない限り、確認を挟まず直す)。修正したら agent をもう一度起動し、指摘が解消したかを確かめる。再監査のたびに手順2と同じくパスだけを渡し、前回の指摘は渡さない。
- 監査は最大2回(初回を含む)。Critical が0件になった回で合格とし、「次は
/to-issues <Planパス>で Issue 化できます」と案内する。 - 2回目の監査で指摘が出たら、Plan ファイルを修正したうえで再監査せずに「次は
/to-issues <Planパス>で Issue 化できます」と案内する。
5. 報告
統合した表を報告する。形式は agent の出力形式に従う。