AI Tools
チュートリアル11 分2026年3月21日執筆:AIGCDev

GitHub Copilot マルチエージェントワークフロー:実リポジトリ向けレビュー優先セットアップ

まず結論

2026年にマルチエージェントのコーディングワークフローを構築するなら、1つの Agent にリポジトリの全制御を渡すところから始めないでください。3つの別々の役割から始めます:1つの Agent が計画を立て、1つのツールがリポジトリコンテキストで編集を実行し、1つのレビュアーが独立して PR をチェックする。純粋な自動操縦より遅いですが、問題が起きたときに何が起きているか把握できる最初のバージョンです。

GitHub の 2026-03-19 の Squad に関する投稿が明確に示した点:難しいのは Agent にコードを1回書かせることではなく、計画・実装・テスト・レビューを、推論を1つの長いチャットの中に隠さずに協調させることです。ほとんどのチームにとって、実用的なワークフローは GitHub Copilot、Cursor、CodeRabbit などの PR レビュアーで構成されるレビュー優先スタックです。

2026 年にマルチエージェント構成が変わった理由

ニュースは「AI Agent がコードを書ける」ではありません。それは既知です。新しいシグナルは、大手ベンダーがリポジトリネイティブのマルチエージェントパターンをデモ扱いではなく公に記述し始めたことです。

2026-03-19、GitHub はリポジトリ内で専門 Agent を協調させるオープンソースプロジェクト Squad の詳細記事を公開しました。有用なのはプロジェクト自体ではなく、パターンです:

  • 共有されたプロジェクト決定がファイルに存在し、チャット履歴だけではない
  • 実装とレビューが分離されている
  • 専門 Agent がそれぞれ自分のコンテキストを持ち、1つの長いスレッドで競合しない
  • 人間が最終的な PR をレビューする

「1つの Agent にすべてやらせて、diff がまともであることを祈る」より、実リポジトリにはるかに適しています。

ワークフロー一覧

役割 ツール すべきこと 単独でやるべきでないこと
プランナー GitHub Copilot タスクを境界のある計画に変換、ファイル・リスク・テストを列挙 コードをマージする、自分の設計を承認する
エディタ Cursor リポジトリコンテキストで境界のある変更を適用 タスク途中でスコープを再定義する
レビュアー CodeRabbit PR を独立レビュー、ギャップを指摘、修正を要求 本番コードの唯一の承認ゲートになる

この分業が重要なのは、最も一般的なマルチエージェントの失敗がロール崩壊だからです。1つのアシスタントが変更を計画し、コードを書き、正しい理由を説明し、同じ作業を「レビュー」する。それは協業ではなく、1つのコンテキストウィンドウの独り言です。

適切なタスク形状でのみ使う

以下のすべてが真のときにマルチエージェントワークフローを使います:

  • タスクが複数ファイルにまたがる、または少なくとも実装1回+レビュー1回を含む
  • コーディング開始前に受入条件を書き下ろせるほど明確
  • リポジトリに保持すべき規約がすでにある
  • 悪いパッチは迷惑だが壊滅的ではない

良い適合:

  • 既存パターンの後ろに境界のある機能を追加
  • テスト付きで重複ロジックをリファクタ
  • コードベースに既存の統合を更新
  • ルーティンのバックエンドまたは UI チケットの最初の PR

悪い適合:

  • ロールバックリスクの高いデータベースマイグレーション
  • 暗黙のビジネスルールがある認証・課金・セキュリティ変更
  • 本当のバグがまだ不明なインシデント
  • グリーンフィールドのアーキテクチャ決定

ステップ1:プランナーに境界のある仕様を作らせる

GitHub Copilot から始めますが、コードの前に計画を求めます。

コピー可能な prompt:

You are planning a repository change.

Return only:
1. files to inspect first
2. the smallest safe implementation path
3. risks or unknowns
4. tests to run
5. one reason to stop and escalate

Rules:
- do not write code yet
- do not propose new dependencies unless strictly required
- if the task is underspecified, say NEEDS-CLARIFICATION first

Task:
[issue またはチケットを貼り付け]

なぜ機能するか:

  • 実行前にスコープを強制する
  • 具体的なファイルリストが得られる
  • エディタが後で越えるべきでない書面の境界を作成する

2026-03-21 時点で、GitHub は Copilot をエディタ・ターミナル・GitHub・カスタム Agent を横断する形で位置づけ、プロダクトページではエディタ内のエージェントモードと issue にアタッチされたバックグラウンドコーディング Agent を明示しています。GitHub の公式プランページでは、個人開発者向けに Free、Pro $10/月、Pro+ $39/月、チーム向けに Business と Enterprise が記載されています。Copilot をループ全体の制御者にしなくても、プランナー層として合理的です。

ステップ2:共有決定をリポジトリに保存する

GitHub の Squad 投稿が正しく指摘し、多くのチームがまだ見落としている点:Agent にメモリが必要なら、リポジトリに置く。

最もシンプルな形は docs/agent-decisions.md のようなプレーン Markdown ファイル:

## 2026-03-21: API ページネーション変更
- 後方互換のため既存レスポンス形式を維持。
- `/v2/reports` にのみカーソルページネーションを追加。
- この PR ではフロントエンドの query hooks をリネームしない。
- テストは空・単一ページ・複数ページのケースをカバー必須。

新しい Agent 実行のたびに古いチャットスレッドを覚えていることを期待するより信頼できます。人間のレビュアーにも明示的な照合基準を提供します。

このファイルに記録すべきもの:

  • 命名決定
  • API 境界
  • すでに選んだライブラリ
  • 次の Agent が継承すべき制約

記録すべきでないもの:

  • 生ログ
  • 長大なトランスクリプト
  • 誰も強制しない推測的メモ

ステップ3:エディタに最小の実変更だけを適用させる

スコープが書き下ろされたら、Cursor に移り、指示を狭く保ちます。

コピー可能な prompt:

Implement only the plan below.

Constraints:
- touch only the files listed unless you hit a blocker
- preserve public API names
- no new dependencies
- stop and explain before expanding scope

Plan:
[承認済みの計画を貼り付け]

Repository decisions:
[関連する決定ブロックを貼り付け]

なぜ Cursor がこのステップに適するか:

  • コンテキスト内で境界のある複数ファイル編集に強い
  • すべてをチャットに隠すのではなく、エディタ内で diff を表示する
  • パッチがドリフトし始めたとき、途中で止めやすい

2026-03-21 時点で、Cursor は Hobby 無料、Pro $20/月、Pro+ $60/月、Teams $40/人/月を記載しています。重要なのは料金自体ではなく、Cursor が Agent リクエスト・フロンティアモデル・cloud agents を含む実行層として価格設定・パッケージされていること。このワークフローのエディタ役にうまくマッピングします。

ステップ4:独立 PR レビューを強制する

起草した Agent に自分の宿題を採点させない。PR を開き、独立レビューを実行します。

レビュアーブリーフの例:

Review this PR as an independent reviewer.

Focus on:
- missing tests
- hidden breaking changes
- places where the implementation violates the stated scope
- security or performance regressions
- unclear naming or documentation gaps

Do not suggest broad rewrites unless the current approach is unsound.

ここが CodeRabbit や他の専用レビュアーが活きる場面です。2026-03-21 時点で、CodeRabbit は PR サマリー用の無料プランと Pro プラン(年払い $24/月、月払い $30/月/開発者)を記載しています。この料金は繰り返しのレビューループに使って初めて意味があり、目新しいコメントボットとしてはありません。

実用的なルール:

  • プランナーは提案できる
  • エディタは起草できる
  • レビュアーは拒否できる
  • 承認とマージだけは人間が行う

ステップ5:実際の検証ゲートを1つ追加する

実際の検証ステップのないマルチエージェントループは、高速な推測にすぎません。

Agent の意見に依存しないチェックを少なくとも1つ選びます:

  • ユニットテストが通る
  • lint と型チェックが通る
  • 変更した画面が正しく描画される
  • API レスポンスが想定の形と一致する
  • レビュアーが主張を証明する正確なファイルを指摘できる

タスクに安価な検証パスがないなら、通常マルチエージェント実行の候補として不適切です。

実践的な日常フロー

実チームで機能する最短バージョン:

  1. タスクを作成し、受入チェックを先に書く
  2. GitHub Copilot に境界のある計画を依頼
  3. 承認した制約をリポジトリの決定ファイルにコピー
  4. Cursor にその計画だけを実装させる
  5. PR の説明にスコープを明記して PR を開く
  6. CodeRabbit にドリフト・ギャップ・テスト不足をレビューさせる
  7. 人間が最終 diff をレビューし、実際のチェックが通った後にのみマージ

これはファンシーなオーケストレーションではありません。複数の Agent を有用に保ち、ノイズにしないための最低限の構造です。

各ツールの得意分野

ニーズ GitHub Copilot Cursor CodeRabbit
チケットを初回計画に変換 強 良 弱
コンテキスト内で複数ファイル編集 良 強 不可
エディタの diff ループ内で作業を維持 中 強 不可
PR を独立レビュー 中 中 強
タスクが不明確なときも有用 中 中 弱
人間の承認者を代替 不可 不可 不可

パターンは単純:Copilot で作業を定義し、Cursor で適用し、CodeRabbit でチャレンジする。

最も多い失敗モード

スコープドリフト

エディタが小さなバグ修正から始めて、静かに命名変更・API 変更・無関係なクリーンアップに拡大する。

対策:書面のファイルリストを保持し、説明なく拡大したパッチは拒否する。

偽レビュー

同じ Agent がパッチを書き、そのパッチが正しい理由を説明する。

対策:独立した PR レビュアー、または異なるジョブを持つ別のモデルコンテキストを使用する。

チャットに隠されたメモリ

良い決定がチャットで1回行われ、次の実行で消える。

対策:永続的な制約をリポジトリファイルに書き込む。

実検証なし

全員が Agent のコメントを読み、実際のチェックは誰も実行しない。

対策:マージ前に交渉不可の検証ゲートを1つ必須にする。

よくある質問

正式なマルチエージェントフレームワークは必要か?

不要です。GitHub の Squad 投稿が示すのは、有用なのはワークフローの形であり、儀式ではないということです。プランナー・エディタ・レビュアーとリポジトリの決定ファイルがあれば、恩恵の大部分は得られます。

GitHub Copilot がループ内の唯一のツールであるべきか?

通常はそうではありません。計画・編集・一部のレビュー支援をカバーできますが、計画・編集・レビューを異なるステップやツールに分離したほうが、ワークフローの信頼性は上がります。

これは単一の強力なコーディング Agent より優れているか?

単一ファイルの小さな編集には、いいえ。追加の協調はオーバーヘッドです。レビューなしの複数ファイルミスのコストが追加レビュー1回のコストを上回るとき、このセットアップに価値が出ます。

最終結論

勝つマルチエージェントワークフローは Agent が最も多いものではなく、境界が最も明確なものです。

GitHub Copilot でパッチを定義し、Cursor でリポジトリコンテキストの中で適用し、CodeRabbit で独立レビューする。永続的な決定はリポジトリに保存し、検証をモデルの自己評価の外に置き、最終マージは人間に任せる。

これが、ライブコードベースで実際に使えるマルチエージェントコーディングのバージョンです。

検証メモ

検証日:2026-03-21。GitHub の 2026-03-19 の Squad 公式ブログ投稿を確認。明示的なリポジトリメモリ・専門役割・独立レビューパターンを含む:https://github.blog/ai-and-ml/github-copilot/how-squad-runs-coordinated-ai-agents-inside-your-repository/。GitHub Copilot 公式プロダクトページとプランページでエディタ Agent モード・バックグラウンドコーディング Agent・Free/Pro($10/月)/Pro+($39/月)を確認:https://github.com/features/copilot および https://github.com/features/copilot/plans。Cursor 公式料金ページで Hobby/Pro($20/月)/Pro+($60/月)/Teams($40/人/月)を確認:https://cursor.com/pricing。CodeRabbit 公式料金ページで Free 枠と Pro 料金(年払い $24/月、月払い $30/月/開発者)を確認:https://www.coderabbit.ai/pricing。

github-copilotcursorcoderabbitai-agentscodingdeveloper-workflow