ツール活用
GitHub Copilot coding agentへ安全に作業を任せる手順
GitHub Copilot coding agentへIssueから実装を依頼するとき、受け入れ条件、変更範囲、テスト、権限を先に定義し、Pull Requestを人が確認する手順を解説します。
- 公開日
- 最終検証
- 次回確認
- 確信度
- HIGH

この記事で分かること
- GitHub Copilot coding agentへ任せるIssueの適切な大きさ
- 変更範囲、受け入れ条件、テストを先に定義する方法
- IssueをCopilotへ割り当ててPull Requestを作らせる流れ
- PRで差分、テスト、権限、安全性を確認する順序
- coding agentへ任せない方がよい作業
注意: coding agentがPRを作成したことは、変更が安全で正しいという意味ではありません。マージ、ワークフロー実行、本番反映の判断は人が行ってください。
先に結論
安全に任せるコツは、指示文を長くすることより、1つのIssueを人がレビューできる差分サイズへ制限することです。変更可能なファイル、変更禁止領域、受け入れ条件、実行すべきテストをIssueへ書き、Copilotが作ったPRを通常の外部コントリビューションと同じ厳しさで確認します。
小さな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が表示されない場合は、次を順に確認します。
- 利用者のCopilotプラン
- 対象リポジトリでのcloud agent有効化
- 組織・Enterpriseのポリシー
- リポジトリの所有形態
- 利用者のIssue・PR権限
プラン変更や管理者設定には組織の承認が必要です。本記事では権限を迂回する方法は扱いません。
まず任せる作業を選ぶ
初回は、次の条件を満たす作業を選びます。
| 比較軸 | 向いている | 向いていない |
|---|---|---|
| 差分 | 数ファイルの小変更 | 全体設計の刷新 |
| 正解 | テストや文言で判定可能 | 関係者の合意が必要 |
| 権限 | リポジトリ内で完結 | 本番・クラウド変更 |
| 影響 | 失敗してもPRを閉じられる | データ消失や停止の恐れ |
| レビュー | 担当者が内容を理解できる | 担当者が読めない技術領域 |
最初の例には、ドキュメント追加、小さなバグ修正、既存テストの追加が適します。依存関係の一括更新、認証変更、課金処理、データ移行、CI権限変更は避けます。
良いIssueに必要な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公式の開始手順は次の通りです。
- cloud agentが有効なリポジトリでIssueを開きます。
- 右側の
Assigneesを選びます。 Copilotを選択します。- 必要なら追加プロンプトへ短い補足を書きます。
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画面、ワークフロー実行方式、組織ポリシーは変更される可能性があります。
PRIMARY SOURCES
確認した一次情報
広告