ツール活用

GitHub Copilot coding agentへ安全に作業を任せる手順

GitHub Copilot coding agentへIssueから実装を依頼するとき、受け入れ条件、変更範囲、テスト、権限を先に定義し、Pull Requestを人が確認する手順を解説します。

公開日
最終検証
次回確認
確信度
HIGH
GitHub CopilotAIエージェントGitHubコードレビュー
AIが作ったコード変更を人がPull Requestで確認するカラフルなイラスト

この記事で分かること

  • GitHub Copilot coding agentへ任せるIssueの適切な大きさ
  • 変更範囲、受け入れ条件、テストを先に定義する方法
  • IssueをCopilotへ割り当ててPull Requestを作らせる流れ
  • PRで差分、テスト、権限、安全性を確認する順序
  • coding agentへ任せない方がよい作業

注意: coding agentがPRを作成したことは、変更が安全で正しいという意味ではありません。マージ、ワークフロー実行、本番反映の判断は人が行ってください。

先に結論

安全に任せるコツは、指示文を長くすることより、1つのIssueを人がレビューできる差分サイズへ制限することです。変更可能なファイル、変更禁止領域、受け入れ条件、実行すべきテストをIssueへ書き、Copilotが作ったPRを通常の外部コントリビューションと同じ厳しさで確認します。

IssueからAI実装と人のレビューへ進む流れ 小さなIssueで範囲を固定し、AIが作ったPRとテストを人が確認してから承認する流れを示す。

GitHubの公式ドキュメントも、Copilotが完了したPRはマージ前に十分確認するよう求めています。エージェントは実装担当であって、承認者ではありません。

利用前提とプラン条件

2026年7月29日時点で、GitHub Copilot cloud agentは有料Copilotプラン向けです。GitHub上のリポジトリで利用できますが、managed user accountが所有するリポジトリと、明示的に無効化されたリポジトリは対象外と案内されています。

Copilot BusinessまたはEnterpriseでは、管理者がcloud agentを有効にする必要があります。IssueのAssigneesにCopilotが表示されない場合は、次を順に確認します。

  1. 利用者のCopilotプラン
  2. 対象リポジトリでのcloud agent有効化
  3. 組織・Enterpriseのポリシー
  4. リポジトリの所有形態
  5. 利用者のIssue・PR権限

プラン変更や管理者設定には組織の承認が必要です。本記事では権限を迂回する方法は扱いません。

まず任せる作業を選ぶ

初回は、次の条件を満たす作業を選びます。

比較軸 向いている 向いていない
差分 数ファイルの小変更 全体設計の刷新
正解 テストや文言で判定可能 関係者の合意が必要
権限 リポジトリ内で完結 本番・クラウド変更
影響 失敗してもPRを閉じられる データ消失や停止の恐れ
レビュー 担当者が内容を理解できる 担当者が読めない技術領域

最初の例には、ドキュメント追加、小さなバグ修正、既存テストの追加が適します。依存関係の一括更新、認証変更、課金処理、データ移行、CI権限変更は避けます。

良いIssueに必要な7項目

  1. 背景:なぜ必要か
  2. 現在の問題:再現手順と実際の結果
  3. 期待結果:利用者から見た成功状態
  4. 変更範囲:編集してよい場所
  5. 変更禁止:触れてはいけない場所
  6. 受け入れ条件:合否を判定できる一覧
  7. 検証方法:実行するテストと確認方法

「いい感じに直す」「関連箇所も改善する」のような指示は、作業範囲を際限なく広げます。発見した別問題は修正せず、PR説明へ記録するよう求めます。

コピペできるIssueテンプレート

以下は、商品一覧の空状態メッセージを修正する小さなIssue例です。

## 背景
検索結果が0件のとき、画面が空白になり、利用者が次の操作を判断できない。

## 現在の動作
1. `/products`を開く
2. 存在しないキーワードで検索する
3. 結果領域が空白になる

## 期待する動作
結果が0件なら「該当する商品がありません。条件を変えて再検索してください。」と表示する。

## 変更してよい範囲
- `src/components/ProductList.*`
- 上記コンポーネントに対応する既存テストファイル

## 変更禁止
- `.github/workflows/**`
- 認証、決済、APIクライアント
- 依存関係とロックファイル
- 文言以外のデザインシステム

## 受け入れ条件
- [ ] 0件のときだけ指定メッセージを表示する
- [ ] 1件以上ではメッセージを表示しない
- [ ] 既存のローディング表示を変えない
- [ ] 既存テストが通る
- [ ] 0件と1件以上のテストを追加する
- [ ] 変更は指定範囲内に収まる

## 検証コマンド
- リポジトリの既存手順に従って対象テストを実行する
- 実行した正確なコマンドと結果をPR本文へ記載する

## 作業上の注意
不明点があれば推測で仕様を追加せず、PRまたはセッション上で質問する。
別の問題を見つけても修正せず、「追加で見つけた事項」として報告する。

ファイル名やテストコマンドは、実際のリポジトリに合わせて置き換えてください。存在しないパスやコマンドを書かないことが重要です。

手順1:Issueを人が事前確認する

Copilotへ割り当てる前に、担当者が次を確認します。

  • 再現手順を人が実行できる
  • 期待結果に曖昧な語がない
  • 変更範囲に必要なファイルが含まれる
  • 変更禁止領域が明記されている
  • テストが受け入れ条件を検証できる
  • Issueだけを読んで完了判定できる

再現できない不具合をそのまま渡すと、原因と仕様を同時に推測させることになります。まず診断だけのIssueとして調査結果を求め、実装修正は別Issueに分ける方法もあります。

手順2:IssueをCopilotへ割り当てる

GitHub公式の開始手順は次の通りです。

  1. cloud agentが有効なリポジトリでIssueを開きます。
  2. 右側のAssigneesを選びます。
  3. Copilotを選択します。
  4. 必要なら追加プロンプトへ短い補足を書きます。
  5. Assignを選びます。

追加プロンプトには新しい仕様を詰め込まず、Issueの境界を再確認する程度にします。

Issueの受け入れ条件をすべて確認してから作業してください。
指定範囲外の変更が必要だと判断した場合は、変更せず理由を報告してください。

割り当て後、Copilotはセッションを開始し、PRの作成へ進みます。セッション画面では、読み取ったファイルや変更状況を確認し、必要なら実行中に方向を修正できます。

手順3:セッションを監視する

次の兆候があれば、完了まで放置せず停止または修正指示を検討します。

  • 指定外のディレクトリを広く変更し始めた
  • workflow、認証、秘密情報周辺を編集しようとしている
  • テスト失敗を無関係として無視している
  • 受け入れ条件にないリファクタリングを追加した
  • 新しい依存関係を導入した
  • 問題を再現できないまま仕様を推測した

「もっと良くして」といった広い修正指示は避けます。例えば「ProductList以外の変更を戻し、0件表示のテストだけに範囲を戻してください」と具体化します。

手順4:PRを安全な順序で確認する

Copilotがレビューを求めてきたら、次の順で確認します。

1. PRの目的と範囲

PRタイトルと説明がIssueに対応しているか、関連Issueが正しくリンクされているかを見ます。説明に追加仕様が書かれていたら、その場で承認しません。

2. 変更ファイル一覧

最初にFiles changed全体を見ます。指定外ファイル、ロックファイル、生成物、.github/workflows/、設定ファイルが含まれていないか確認します。

3. 差分の意味

行ごとに、必要な変更か、既存動作を壊さないか、エラー処理を省略していないかを確認します。整形だけの大量差分は、実質的な変更を見えにくくするため分離を求めます。

4. テストコード

受け入れ条件の各項目に対応するテストがあるか見ます。テストが実装内部の細部だけを確認し、利用者から見た動作を検証していない場合は不足です。

5. 実行結果

PR本文に記載されたコマンドと結果を確認します。「テスト済み」だけでは不十分です。実行コマンド、成功件数、失敗・スキップの有無を求めます。

6. 人の再実行

信頼できる環境でテストを再実行します。重要変更では、対象テストだけでなく関連テスト、lint、型検査、ビルドも既存手順に従って実行します。

7. 受け入れ条件との照合

Issueのチェック項目を1つずつ、差分またはテストへ対応付けます。対応先が説明できない項目は完了扱いにしません。

GitHub Actionsを実行する前の注意

GitHub公式ドキュメントでは、CopilotがPRへ変更をプッシュしても、既定ではGitHub Actionsワークフローは自動実行されないと説明されています。PRのマージボックスにApprove and run workflowsが表示される場合があります。

ワークフローは秘密情報や強い権限へアクセスできる可能性があります。実行を承認する前に、.github/workflows/の差分と、呼び出されるスクリプトを確認してください。 ワークフロー変更を含むPRを初回委任の題材にしない方が安全です。

自動実行を許可する設定もありますが、変更元、利用できるシークレット、トークン権限、保護ルールを組織として評価した後に限定します。

修正を依頼する方法

PRコメントで@copilotへ具体的に依頼できます。

@copilot 受け入れ条件の「1件以上では空状態メッセージを表示しない」を検証するテストがありません。
指定済みのテストファイルだけを変更し、1件ある場合のテストを追加してください。
実装コードとworkflow、依存関係は変更しないでください。

「レビュー指摘を全部直して」ではなく、未達条件、変更可能範囲、変更禁止範囲を再掲します。修正コミットが追加されたら、最初のレビュー結果を流用せず、新しい差分を再確認します。

期待結果と完了条件

確認対象 完了条件
変更範囲 Issueで許可したファイルだけ
実装 期待動作と一致し、不要な仕様追加なし
テスト 受け入れ条件を直接検証
CI 承認済みのワークフローが成功
安全性 秘密情報、権限、依存関係へ意図しない変更なし
レビュー 内容を理解する人が差分を確認

GitHubの公式説明では、リポジトリでPR承認が必須の場合、Copilot PRに対する依頼者自身の承認は必要承認数へ数えられず、別のレビュアーによる承認が必要です。実際のブランチ保護・rulesetも確認してください。

失敗モードと対処

Issueが大きすぎる

設計変更、実装、移行、ドキュメント更新を分割します。1つのPRで安全にレビューできる単位を超えたら、先に調査Issueを作ります。

テストが通るが要件を満たさない

既存テストだけでは新要件を検証していない可能性があります。受け入れ条件ごとのテスト対応表を作ります。

指定外の改善が混ざる

無関係な変更を別Issueへ切り出し、現在のPRから除外させます。差分が小さいこと自体を品質条件にします。

AI生成だから速く承認する

GitHubはCopilot PRも他の貢献と同じように十分レビューするよう案内しています。生成者ではなく、差分の内容と検証結果で判断します。

人が理解できない変更を受け入れる

説明を求めても担当者が安全性を判断できないなら、その変更は採用しません。専門知識を持つレビュアーを追加するか、人が実装し直します。

任せない作業

初期運用では、次をcoding agentへ丸ごと委任しません。

  • 本番データの削除・移行・復旧
  • 認証、認可、暗号鍵、秘密情報の変更
  • 課金、決済、会計ロジック
  • GitHub Actionsやデプロイ権限の全面変更
  • 重大インシデント中の即時本番操作
  • 法的・規制上の判断を含む実装
  • 仕様責任者が決まっていない大規模リファクタリング
  • テスト環境で再現できない破壊的変更

これらでAIを使う場合も、読み取り専用の調査、テスト案の作成、差分レビュー補助など、状態を変えない範囲から始めます。

事実と編集部の判断

公式情報から確認できること

  • cloud agentは有料Copilotプラン向けで、組織プランでは管理者設定が関係する
  • IssueのAssigneesからCopilotへ割り当てるとセッションとPR作成が始まる
  • 完成したPRはマージ前に十分レビューする必要がある
  • GitHub Actionsは既定で自動実行されず、実行前に特権的なワークフロー変更を確認すべきである

AI活用ナビの運用判断

変更禁止領域、差分サイズ、7段階のPR確認順、初期運用で任せない作業は、公式情報を踏まえた編集部の安全設計です。すべてのリポジトリに同じ境界が適用できるわけではないため、脅威モデルと開発規程に合わせて強化してください。

AI活用ナビの判断

AI活用ナビの判断: coding agent導入の成否は、プロンプトの巧さよりIssueとレビュー工程で決まります。小さなIssue、明示的な変更禁止領域、検証可能な受け入れ条件、人による差分確認を必須にしてください。

速度を理由に承認工程を省略すると、PRという安全な境界を自分で外すことになります。まず低リスクな1件で運用を試し、指示逸脱、レビュー時間、テスト不足を記録してから対象範囲を広げます。

確認日と公式情報

確認日:2026年8月22日。プラン条件、対象リポジトリ、Agents画面、ワークフロー実行方式、組織ポリシーは変更される可能性があります。

確認した一次情報

  1. About GitHub Copilot coding agentGitHub · 2026年8月22日
  2. Review Copilot coding agent outputGitHub · 2026年8月22日