plan-review

Plan Review

GitHub Copilot CLI (gh copilot -- -p) を使い、観点別にサブエージェントを並列起動して実装計画・設計ドキュメントをレビューするスキル。

各サブエージェントがそれぞれ専門の観点で copilot -p を実行し、結果を統合して報告する。これにより、単一プロンプトでは見落としがちな問題を多角的に検出できる。

ワークフロー

Step 1: レビュー対象の特定

ユーザーの指示から対象を判断する：

ユーザーの意図	取得方法
ファイルパスを明示	指定されたファイルをそのまま読む
「最新のプラン」「直近の計画」	~/.claude/plans/ 内の最新ファイルを使用
会話中の計画内容	会話に含まれるプラン内容を抽出

明示的な指定がなければ ~/.claude/plans/ 内のファイルを確認し、最新のものを対象とする。それも存在しない場合はユーザーにファイルパスを尋ねる。

Step 2: 計画内容を一時ファイルに保存

サブエージェントから参照できるよう、計画内容を一時ファイルに書き出す：

cat <対象ファイル> > /tmp/plan-review-content.md
# または会話内容の場合は直接書き込む

内容が空の場合は、その旨をユーザーに伝えて終了する。

Step 3: 観点別サブエージェントを並列起動

以下の5つのサブエージェントを 同時に Agent toolで起動する。各サブエージェントは独立して copilot -p を実行する。

サブエージェント一覧

#	観点	サブエージェント名	専門プロンプト
1	実現可能性・技術リスク	review-feasibility	技術的な実現可能性、依存関係のリスク、未解決の技術課題、見積もりの妥当性を評価
2	アーキテクチャ・設計品質	review-architecture	設計の一貫性、コンポーネント間の結合度、抽象化レベルの適切さ、既知のアンチパターンを評価
3	網羅性・考慮漏れ	review-completeness	要件の漏れ、エッジケースの未考慮、ステークホルダーへの影響、依存する外部システムの考慮を評価
4	セキュリティ・データ保護	review-security	認証・認可の設計、機密データの取り扱い、脅威モデル、コンプライアンス要件を評価
5	スケーラビリティ・運用性	review-scalability	負荷増大への対応、運用監視の設計、障害復旧計画、デプロイ戦略を評価

各サブエージェントへ渡すプロンプトは以下のテンプレートに従う：

/tmp/plan-review-content.md に実装計画・設計ドキュメントがある。
以下のコマンドを実行し、その出力をそのまま報告せよ：

cat /tmp/plan-review-content.md | gh copilot -- -p \
  "<観点別の専門プロンプト>
  計画内容はstdinから渡される。
  問題が見つかった場合は、該当箇所・問題の説明・改善案を含めること。
  問題がなければ「この観点では問題は見つかりませんでした」と報告すること。
  日本語で回答すること。" \
  -s

コマンドの出力をそのまま返すこと。

ユーザーがモデルを指定した場合は、各コマンドに --model <モデル名> を追加する。

ユーザーが特定の観点のみを指定した場合（例：「セキュリティだけ見て」）は、該当する観点のサブエージェントのみ起動する。

Step 4: 結果の統合と報告

全サブエージェントの完了後、結果を以下の形式で統合して報告する：

## Plan Review 結果

### 実現可能性・技術リスク
<review-feasibility の出力>

### アーキテクチャ・設計品質
<review-architecture の出力>

### 網羅性・考慮漏れ
<review-completeness の出力>

### セキュリティ・データ保護
<review-security の出力>

### スケーラビリティ・運用性
<review-scalability の出力>

各観点で「問題なし」の場合はその旨を簡潔に記載する。重要度の高い指摘（実現可能性・セキュリティ）は冒頭にサマリーとしてまとめると見やすい。

コマンドリファレンス

# 基本形
cat /tmp/plan-review-content.md | gh copilot -- -p "<プロンプト>" -s

# モデル指定
cat /tmp/plan-review-content.md | gh copilot -- -p "<プロンプト>" --model claude-opus-4.6 -s

• -p: 非対話モード（プロンプトを渡して実行、完了後終了）
• -s: エージェント応答のみ出力（統計情報を省略）
• --model: 使用するAIモデルを指定（任意）

注意事項

• 計画内容が空の場合はcopilotを呼ばず、ユーザーに通知して終了する
• gh copilot が未インストールの環境では gh copilot のインストールを案内する
• 計画書が非常に大きい場合（5000行超）はセクション単位で分割してレビューを検討する
• 各サブエージェントのcopilot実行はタイムアウト（3分）を設定する
• コードレビュー（差分レビュー）は copilot-review スキルを使用すること