Agent Merge は PR のマージを妨げるものを直す機能

GitHub は 2026 年 10 月 28 日、Agent Merge の changelog を公開しました。Copilot が PR を監視し、失敗した GitHub Actions やマージ競合のように、マージを妨げるものをクラウドの開発環境で直す機能です。Copilot app と VS Code では既に使えて、今回 GitHub の PR にも統合されました。

この記事では、GitHub の PR で使う側に絞って、次の点を公式の資料から整理します。

  • 何を直せて、何を直せないか
  • 有効にする手順と、使える条件
  • 課金は誰に付くか
  • 止め方と、公式に書かれていないこと

読む資料は、先の changelog と、公式ドキュメントのプルリクエストをマージできる状態にする手順です。当社が Agent Merge を実機で検証した結果ではなく、2026 年 11 月 4 日時点の公式情報の整理です。Copilot の機能を組織で有効にする方針は GitHub Copilot のデフォルトの有効化ポリシー の記事にまとめています。

直せるのは Actions の失敗とマージ競合の 2 つ

Agent Merge は、選んだ対象 (Actions の失敗やマージ競合) が PR で起きたときに、修正の作業を始めます。選べる対象は次の 2 つです。

対象Copilot がすること
失敗した Actions失敗したワークフローを直す
マージ競合ベースブランチとの競合を解消する

公式ドキュメントは、対象をこの 2 つに限っています。レビューコメントへの対応や、テストの追加のような作業は、Agent Merge の対象として書かれていません。

修正は、クラウドの開発環境で行われます。Copilot が作業を始めると、PR のタイムラインに、失敗したワークフローやマージ競合のように、始めた理由を示す記録が残ります。

FIXITFIXIT

CI が赤くなったら、Copilot が勝手に直してくれるってこと?

KanameKaname

選んだ対象についてはそうです。ただ、直した内容の確認は、これまでどおり人の仕事として残ります。

有効にする手順

1 本の PR で使うときの手順は、公式ドキュメントでは次のとおりです。

  1. GitHub で PR を開く
  2. マージボックスの Watch and fix を選ぶ
  3. Fix failed Actions workflows、Resolve merge conflicts、またはその両方を選ぶ

自分が作る PR で毎回使いたいときは、Settings の Copilot > Cloud で Enable Agent Merge automatically for pull requests I create をオンにします。そのうえで、設定画面のスイッチで、直す対象を選べます。changelog にも、Copilot の設定でデフォルトの有効化ができると書かれています。

状況は、マージボックスの Agent Merge の欄で確認できます。

使える条件と、使えない PR

使うための条件は、公式ドキュメントに次のように書かれています。

項目内容
プランクラウドで Copilot を使える有料の Copilot プラン
組織・Enterprise組織や Enterprise から Copilot を提供されている場合は、そのポリシーがクラウド利用を許可していること
リポジトリのポリシーCopilot の Enable automations が有効であること
使えない PRstacked PR と、fork から開いた PR

fork から貢献を受けるリポジトリでは、外部の貢献者が出す PR には使えません。導入前にこの制約を確認してください。

課金は誰に付くか

公式ドキュメントによると、Agent Merge が使う AI クレジットは、その PR で Agent Merge を有効にした人に付きます。PR の作者と別の人になることがあります。たとえば、他の人の PR で Watch and fix を選ぶと、費用は選んだ人の負担です。

一方で、参照したページには次のことが書かれていません。

  • premium requests を使うかどうか
  • GitHub Actions の実行時間をどう扱うか
  • 1 回の修正でどれくらいの AI クレジットを使うか

費用の試算はできません。上限や単価は、公式の Copilot の課金と利用量のドキュメントで確認してください。

レビュー・auto-merge との関係

公式ドキュメントは、Agent Merge は人によるレビューやリポジトリのマージ要件の代わりにならないと明記しています。有効にしても、リポジトリのマージ要件は外れません。Copilot が直した変更も、ワークフローの結果と合わせて、マージ前に人が確認する前提です。

auto-merge は、必要なレビューとステータスチェックがそろった時点でマージする機能です。Agent Merge は auto-merge を自動ではオンにしません。changelog は、Agent Merge と auto-merge を併用できると案内しています。Copilot が PR を整えて、要件がそろったときに GitHub がマージする流れです。

FIXITFIXIT

じゃあ、auto-merge と組み合わせたら人は何も見なくていいの?

KanameKaname

そうはなりません。auto-merge の条件に必要なレビューを入れておけば、承認は人に残ります。

止め方と、書かれていないこと

止めるときは、PR のマージボックスで Unassign Copilot を選びます。Agent Merge を有効にした人か、リポジトリの書き込み権限を持つ人が操作できます。

次の点は、changelog にも公式ドキュメントにも書かれていません。

  • ベータか一般提供かという提供段階
  • リポジトリや組織の単位で、Agent Merge だけを無効にする設定

この記事では、公式に記載のある範囲だけを扱います。管理者が制御したいときは、「使える条件と、使えない PR」の節の Enable automations ポリシーと、組織のポリシーで確認してください。

Agent Merge が修正を行う環境を設定する

公式ドキュメントでは、Agent Merge の修正は、クラウドのサンドボックスではなく、GitHub Actions をもとにした環境で行われると書かれています。GitHub Actions 上で動く Copilot の他のタスクと同じ設定が使えます。

  • .github/workflows/copilot-setup-steps.yml のセットアップ手順
  • リポジトリのカスタム指示
  • リポジトリのエージェントスキル

これらを整えると、Agent Merge の修正にも反映されます。セットアップ手順の書き方は、公式ドキュメントの Copilot のクラウド向けのページで確認してください。

FIXIT の運用|任せる範囲を先に決める

AI 駆動開発のクリエイティブスタジオである FIXIT としては、PR の修正を AI に任せるときに、任せる対象、承認する人、費用を負担する人の 3 つを先に決めておくことを勧めます。Agent Merge は、課金が有効にした人に付き、人のレビューは残る仕組みです。誰が Watch and fix を選ぶか、どの種類の PR で使うかを決めておくと、運用がぶれにくくなります。

本記事は公式情報に基づく解説です。FIXIT による Agent Merge の検証結果や、導入実績を示すものではありません。

まとめ

Agent Merge は、GitHub の PR で、失敗した Actions とマージ競合を Copilot に直させる機能です。有料の Copilot プランと Enable automations ポリシーが必要になり、stacked PR と fork から開いた PR は使えません。AI クレジットは有効にした人に付き、人のレビューとマージ要件は置き換わりません。

次の一歩は、リスクの低い PR を 1 本選んで Watch and fix を試し、直した内容と費用を確認することです。提供段階とリポジトリ単位の無効化は公式に書かれていないため、導入前に管理者と確認してください。

チームで AI ツールの運用ルールを決めたい場合は、AI 開発ツール定着支援 をご覧ください。現在の環境を踏まえて相談したい場合は、お問い合わせ からご連絡ください。Copilot の最近の変更は GitHub Copilot Fusion とは に、ツールの比較は Claude Code・Cursor・GitHub Copilot の比較 にまとめています。