name: plan-review description: "GitHub Copilot CLIを使って実装計画・設計ドキュメントを観点別に並列レビューするスキル。プランファイル、設計書、アーキテクチャドキュメントを複数のサブエージェントがcopilot -pで同時にレビューする。ユーザーが「計画をレビュー」「プランを確認」「設計を見て」「計画の問題点を指摘」などと言ったときに使用する。"
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スキルを使用すること