copilot-review

Copilot Review

GitHub Copilot CLI (gh copilot -- -p) を使い、copilot 側でサブエージェントを並列起動してコード差分をレビューするスキル。

copilot に対して5つの観点を並列実行するよう指示し、copilot 自身がサブエージェントを使って結果を統合・報告する。

ワークフロー

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

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

ユーザーの意図	diffコマンド
「直近の差分」「変更をレビュー」	git diff (未ステージ) / git diff --cached (ステージ済み)
「最新コミットをレビュー」	git diff HEAD~1
「PRをレビュー」	gh pr diff <番号>
「ブランチの差分」	git diff main...HEAD 等
具体的なコミット範囲	指定範囲のdiff

明示的な指定がなければ git status で確認し、未コミット変更があればそれを、なければ最新コミットの差分を対象とする。

Step 2: 差分を一時ファイルに保存

git diff <対象> > /tmp/copilot-review-diff.patch

差分がない場合は、その旨をユーザーに伝えて終了する。

Step 3: copilot に並列レビューを依頼

以下のコマンドを 1回だけ 実行する。copilot 側が5つの観点のサブエージェントを並列起動してレビューを実行する。

cat /tmp/copilot-review-diff.patch | gh copilot -- -p \
  "stdinに渡されたコードの差分を、以下の5つの観点でサブエージェントを使って並列レビューせよ。

  各観点のサブエージェントを同時に起動し、それぞれ独立してレビューを実施すること：

  1. バグ・ロジック: バグ、ロジックの誤り、エッジケースの見落とし、型の不整合を検出
  2. セキュリティ: インジェクション、認証/認可の不備、機密情報の露出、OWASP Top 10を検出
  3. エラーハンドリング: 未処理例外、不適切なエラー伝播、リソースリーク、リトライ不足を検出
  4. パフォーマンス: N+1クエリ、不要なループ、メモリ効率、アルゴリズム計算量の問題を検出
  5. 可読性・保守性: 命名、コードの複雑性、重複、設計パターンの改善点を検出

  各観点について：
  - 問題が見つかった場合はファイル名・行番号・問題の説明・修正案を含めること
  - 問題がなければ「この観点では問題は見つかりませんでした」と報告すること

  全観点の結果を以下の形式で統合して日本語で報告すること：

  ## Copilot Review 結果

  ### バグ・ロジック
  <レビュー結果>

  ### セキュリティ
  <レビュー結果>

  ### エラーハンドリング
  <レビュー結果>

  ### パフォーマンス
  <レビュー結果>

  ### 可読性・保守性
  <レビュー結果>" \
  --allow-tool 'shell(git)' -s

ユーザーがモデルを指定した場合は --model <モデル名> を追加する。

ユーザーが特定の観点のみを指定した場合（例：「セキュリティだけ見て」）は、プロンプト内の観点リストを該当するものだけに絞る。

Step 4: 結果の報告

copilot の出力をそのままユーザーに報告する。重要度の高い指摘（バグ・セキュリティ）があれば冒頭にサマリーを補足する。

コマンドリファレンス

# 基本形
cat /tmp/copilot-review-diff.patch | gh copilot -- -p "<プロンプト>" --allow-tool 'shell(git)' -s

# モデル指定
cat /tmp/copilot-review-diff.patch | gh copilot -- -p "<プロンプト>" --model claude-opus-4.6 --allow-tool 'shell(git)' -s

• -p: 非対話モード（プロンプトを渡して実行、完了後終了）
• -s: エージェント応答のみ出力（統計情報を省略）
• --allow-tool 'shell(git)': gitコマンドへのアクセスを許可
• --model: 使用するAIモデルを指定（任意）

注意事項

• 差分がない場合はcopilotを呼ばず、ユーザーに通知して終了する
• gh copilot が未インストールの環境では gh copilot のインストールを案内する
• 差分が非常に大きい場合（5000行超）はファイル単位で分割してレビューを検討する
• copilot の実行はタイムアウト（5分）を考慮する