| name | plan-quality-check |
| description | 計画の不足情報・リスク・暗黙の前提・完了条件・次アクションを軽量に構造化抽出する。Use when: 計画の品質を実装前に確認したい時、Missing Items / Risks / Assumptions / Done Criteria を JSON 化したい時、重い Gate を使わず計画健全性を素早く見える化したい時。 |
Plan Quality Check
計画文書（目的・スコープ・成功条件・完了条件）を読み、品質を構造化して
返す軽量 Check の Skill。重い Gate / Agent orchestration / PR review /
QA automation には依存しない（手動実行可能・補助情報）。
カテゴリ
Design
想定 Phase
計画レビュー前後の軽量確認（計画作成直後・実装着手前）
役割
3 種の Check を単独または統合（combined）で実行する:
| Check | 目的 | 主出力 |
|---|
plan_check | 目的・対象・成功条件・スコープの明確さを確認 | score / missing_items / summary |
risk_check | 失敗要因・依存関係・未決事項・暗黙の前提を確認 | risks / assumptions / next_actions |
done_check | 完了条件・検証方法・リリース後確認を確認 | done_criteria / validation_notes |
補足: done_check は**停止条件（completion / stop condition）の記述有無を、risk_check は再計画トリガ（前提崩壊・逸脱を検知する定量条件）**の記述有無を確認観点に含める。いずれも汎用観点であり、具体のチェック項目はプロジェクト側テンプレート（例 review-self）で定義する。
補足2: high-risk / critical の実装タスクでは rollback（戻し手順）の記述有無を done_check の確認観点に含める。rollback 欠落は安全側（needs_clarification）に倒す。具体項目は review-self テンプレで定義（C1-TODO-RB）。
補足3（TASK-0129 / #543）: Loop 安全制御チェックを done_check / risk_check 観点に追加する:
| ID | チェック内容 | 判定 |
|---|
| C1-LOOP-01 | plan に Stop Condition（停止条件）が記入されているか | 未記入 → WARN（high-risk/critical では FAIL） |
| C1-LOOP-02 | plan に Replan Triggers と機械値（閾値）が記入されているか | 未記入 → WARN、機械値なし → WARN（high-risk/critical では FAIL） |
これらは #544/#551 の Loop 安全制御（Phase1 検出）と連動し、
C-3 承認不可の strict Gate（Phase2）へ接続する（docs/ai/review-gate-decision-mapping.md §5 参照）。
入力
- 計画文書（目的 / スコープ / 受入基準 / 完了条件を含むテキスト）
- 任意: 確認したい Check 種別（plan_check / risk_check / done_check / combined）
出力
- 結果 JSON（
score, decision, summary, missing_items, risks,
assumptions, done_criteria, next_actions, 任意 score_breakdown,
validation_notes）
- 出力構造はリポジトリ側スキーマ（
schemas/plan-quality-check.schema.json）
に準拠させる
- 自由文サマリも併記してよいが、機械処理対象は JSON とする
Plan Health Score の考え方
0-100。最小内訳: goal_clarity / scope_defined / success_metric /
risks_identified / done_criteria_defined。閾値で助言的に
ready / needs_clarification / insufficient を返す。
制約
- 本 Check の
decision は 助言であり、人間承認・ゲート判定の
代替にしない。
- 重い自動実行（PR review / browser QA / pair-agent）を呼び出さない。
- 不足が判定不能なときは安全側（より低い score / needs_clarification）。
