mcpField
P
plan-review

plan-review

github.com/camachoエージェントワークフロー658 回インストール
リポジトリ

plan-review について

plan-reviewは、ビルド開始前に計画を審査するゲートを実行します。複数のエージェントの判定を並行して集め、承認状況と指摘の優先度に基づいて続行、修正、エスカレーションを判断します。

主な機能

  1. 01対象の計画ファイル検索
  2. 02レビューパネルの編成
  3. 03エージェントレビューの並列実行
  4. 04判定と指摘事項の集約
  5. 05承認・エスカレーション条件の適用

活用シーン

  1. 01実装前の計画審査
  2. 02複数エージェントからの意見収集
  3. 03未解決の計画指摘のエスカレーション

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/camacho/ai-skills --skill plan-review

インストール後、Claude Code で/plan-reviewを入力して読み込まれたか確認します。

詳細

フェーズゲート：PLAN チェックポイント。Build に進む前に、すべてのレビュアーから APPROVE を得る必要があります。

入力

  • 計画ファイルのパス（デフォルト：ai-workspace/plans/ 内で最新の .done.md ではないファイル）
  • --include <agent>：パネルにエージェントを強制的に追加します
  • --exclude <agent>：エージェントを除外します（除外できない technical-editor を除く）

手順

  1. 計画ファイルを見つけます：

    ls -t "$(git rev-parse --show-toplevel)/ai-workspace/plans/"*.md | grep -v '.done.md' | head -1

    計画ファイルが見つからない場合 → エラー：「ai-workspace/plans/ に計画ファイルがありません。先に計画を作成してください。」 計画ファイルが .done.md の場合 → エラー：「この計画はすでに最終確定されています。」

  2. 計画を読み込み、次の内容を抽出します：

    • Files to Modify セクション
    • 本文全体
    • 計画の範囲（変更ファイル数、本文の行数）

  3. レビューパネルを編成します — /assemble-panel をスコープ = 計画ファイルで実行します。計画内のファイル形式とキーワードに基づいてパネルが返されます。上書き指定として --include／--exclude を渡します。選定されたエージェントと選定理由を記録します。

    Codex/Cursor：.claude/skills/assemble-panel/SKILL.md を直接読み、スコープ／キーワードのマップをその場で適用します。

    /assemble-panel を利用できない場合は、gate=P2、cap=3 で [technical-editor, code-reviewer] にフォールバックします。

  4. 選定されたすべてのエージェントを Agent ツールで並列にディスパッチします（1 つのメッセージで複数の Agent ツール呼び出しを行います）。各エージェントには次の内容を渡します：

    • 計画ファイルの内容
    • 各エージェント固有のレビュー指示
    • P0／P1／P2 のタグ付き所見とともに、APPROVE／REVISE／DROP を返す指示

  5. 判定を収集し、次の要約テーブルにまとめます：

    ## Plan Review Summary
| Agent | Verdict | P0 | P1 | P2 | Key Finding |
|-------|---------|----|----|-----|-------------|

  6. ゲートのロジックとレビューループ — パネルのガバナンスには /assemble-panel を実行します。ポリシーの代数（gate=P2、cap=3）を提示し、RETAIN、EXPAND、CONVERGE、ESCALATE_RECURRING を処理します。ここでこれらのルールを重複して記載しないでください。

    各ラウンドの後：

    • すべてが APPROVE で、ゲートを超える所見がない → 「Build に進む」
    • ゲートを超える所見が残っている → 修正し、assemble-panel の RETAIN + EXPAND ルールに従って再レビューします
    • 未解決の所見がある状態で上限に達した → 人間にエスカレーションします

    /assemble-panel を利用できない場合のフォールバック：ゲートを超える所見があるレビュアーをすべて維持し、第 3 ラウンド、またはすべての問題が解消した時点で終了します。

パネルの範囲

  • 最小：technical-editor のみ（単純な計画ではエージェント 1 名）
  • 通常：technical-editor + code-reviewer + architect-reviewer（3 名）
  • 最大：全エージェント（大規模で複数領域にまたがる計画の場合のみ）

コメント

Markdown 対応