1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

GitHub Copilot Coding AgentがGAに:IssueをアサインするだけでPRが届く自律型エージェントの実践ガイド

1
Posted at

この記事で得られること

GitHub Copilot の Coding Agent(コーディングエージェント)が正式リリース(GA)されました。

これは単なるコード補完や Chat 機能の延長ではなく、GitHub Actions 環境で自律的に動作するエージェントです。Issue を Copilot にアサインするだけで、ブランチの作成からコード実装、PR の作成、CI 失敗時の自動修正まで非同期で進めてくれます。

さらに 2026年3月のアップデートでは、PR のコメントで @copilot をメンションして直接コミットを追加させる機能と、Jira チケットからの起動も可能になりました。

この記事では以下を解説します:

  • Coding Agent の仕組みと従来の Copilot との違い
  • 有効化手順とリポジトリの準備
  • Issue から PR が生成されるまでの実際の流れ
  • PR コメントで @copilot をメンションして直接修正させる方法
  • 実務で使うときの5つのコツ

対象読者: GitHub Copilot を使ったことがある中級エンジニア。


Coding Agent は何が違うのか

これまでの GitHub Copilot(コード補完・Copilot Chat)は「人間の操作を支援する」ツールでした。コードの候補を出す、質問に答える、テストを生成する——いずれも人間がトリガーし、出力を確認・適用するまでが1サイクルです。

Coding Agent はこれを根本から変えます。

  • 非同期: Issue をアサインしたら、あとは待つだけ。別の作業をしている間にエージェントが動く
  • 自律的: ブランチ作成→コード実装→commit→PR 作成→CI 失敗時の修正、というサイクルを自分で回す
  • GitHub Actions 環境で動く: ローカル環境を汚さず、ログも GitHub 上で確認できる

ひとことで言えば「Issue を受け取り、自分でコードを書いて PR を出す開発者」として振る舞います。


有効化手順

前提条件

  • GitHub Copilot Enterprise / Copilot Business、または個人向け Copilot Pro+ のサブスクリプション
  • リポジトリに GitHub Actions が有効になっている

Organization レベルでの有効化

  1. GitHub の Organization 設定を開く
  2. [Copilot] → [Policies] に移動
  3. "Coding agent"Enabled にする

リポジトリへの権限付与

Coding Agent は PR の作成とコードの push を行うため、権限設定が必要です。

  1. リポジトリの [Settings] → [Actions] → [General] を開く
  2. "Workflow permissions"Read and write permissions に設定
  3. "Allow GitHub Actions to create and approve pull requests" にチェック

これで Coding Agent が動ける最低限の権限が揃います。


Issue から PR が届くまでの流れ

Step 1: Issue を Copilot にアサインする

既存の Issue を開き、Assignees の欄から Copilot を選択します。Issue 作成時に最初からアサインしても構いません。

Assignees: Copilot

これだけです。あとは Copilot が自律的に動き始めます。

Step 2: エージェントの動作を確認する

Issue のコメント欄に Copilot からのステータス更新が届きます。

🤖 Copilot は作業を開始しました
  ブランチ: copilot/fix-login-validation-12

進捗: コードの分析中...

GitHub Actions のワークフロー実行ログでも詳細な進捗を確認できます。処理時間はタスクの複雑さによりますが、数分〜数十分程度です。

Step 3: PR をレビューする

作業が完了すると PR が自動作成されます。PR には以下が含まれます:

  • 変更の説明: 何をどう変更したかの詳細なサマリー
  • 実装の根拠: Issue の要件をどう解釈して実装したか
  • テストの追加: 変更に対応したテストコードが自動追加されることもある

あとは通常のコードレビューフローと同じです。問題なければマージするだけです。


PR コメントで @copilot を呼ぶ

PR のレビュー中に修正を依頼したい場合、コメントで @copilot をメンションするだけで Copilot が直接コミットを追加してくれます。

使い方

@copilot エラーハンドリングが抜けています。
fetch 呼び出しに try-catch を追加して、
エラー時は console.error でログを出すようにしてください。

Copilot はコメントの内容を解釈し、対象ファイルを特定して修正します。修正完了後、コメントへの返信としてどのコミットで変更したかが示されます。

活用シーン

シーン コメント例
エラーハンドリング追加 @copilot この関数に try-catch を追加してください
テスト追加 @copilot 境界値のテストケースを追加してください
型定義修正 @copilot any を使わず適切な型に修正してください
リネーム @copilot 変数名 data を userData にリネームしてください

レビューで見つけた軽微な問題をその場で即修正させられるため、レビューサイクルが大幅に短縮します。


Jira 連携(2026年3月〜)

2026年3月から Jira チケットからも Coding Agent を起動できるようになりました(パブリックプレビュー)。

GitHub の Issue がない場合でも、Jira チケットを Copilot に割り当てるだけで同じフローが動きます。

Jira チケット: PROJ-1234「ログインフォームのバリデーション強化」
担当者: Copilot
→ 自動でブランチ作成 → 実装 → PR 作成

Jira でプロジェクト管理しているチームにとっては、GitHub と Jira を往復せずに済む大きなメリットです。


実務で使うための5つのコツ

1. Issue の説明を具体的に書く

Copilot は Issue の本文を読んで実装方針を決めます。曖昧な Issue は曖昧な実装になります。

# 悪い例
ログインのバグを直してください

# 良い例
## 問題
メールアドレスに空白が含まれる場合、バリデーションがスルーされる

## 期待する動作
trim() 処理を行い、前後の空白を除去した上でバリデーションする

## 対象ファイル
src/auth/validate.ts の validateEmail 関数

2. CI を整備してから使う

Coding Agent は CI が失敗したら自動で修正を試みます。逆に言えば、テスト・lint が整備されていないと品質の担保ができません

Copilot を活用するモチベーションとして、テスト環境を整えるきっかけにもなります。

3. スコープを小さく切る

「〇〇機能の全体実装」よりも「〇〇機能の△△コンポーネントの実装」のように、Issue を小さく切ったほうが精度が高くなります。大きな Issue は人間が分解してからアサインするのがベストプラクティスです。

4. .github/copilot-instructions.md でコーディング規約を渡す

Coding Agent はこのファイルを読んでコードを書きます。チームのコーディング規約や使用するライブラリをここに書いておくと、一貫性のある実装が得られます。

# コーディング規約

- TypeScript strict モードを使用すること
- 非同期処理は async/await を使い、Promise チェーンは使わない
- エラーハンドリングは Result 型パターンで統一
- テストフレームワーク: Vitest
- コンポーネントライブラリ: shadcn/ui

5. セキュリティ関連は必ず人間がレビューする

Coding Agent が生成したコードは必ずレビューしてください。特に以下は自動マージ設定を絶対に有効にしてはいけません:

  • 認証・権限・API キー周りの実装
  • DB スキーマの変更
  • 外部 API との連携コード

Copilot は指示通りに実装しますが、セキュリティ上の意図や設計の全体像は人間が持っています。


どんなタスクが向いているか

実際に試した感触から、Coding Agent に向いているタスク・向いていないタスクをまとめます。

向いているタスク:

  • バグ修正(再現手順が明確なもの)
  • テストの追加・充実
  • 既存コードのリファクタリング(変数名変更・型定義整理等)
  • ドキュメント生成(JSDoc・README)
  • ボイラープレートが多い CRUD 操作の実装

向いていないタスク:

  • 新しいアーキテクチャの設計・大規模リファクタリング
  • 曖昧な要件(「いい感じにして」)
  • 複数のリポジトリをまたぐ変更
  • パフォーマンスチューニング(プロファイリング結果の解釈が必要)

まとめ

GitHub Copilot Coding Agent を使いこなすポイントは3つです:

  1. Issue を具体的に書く — Copilot はあなたが書いた Issue を読んでコードを書く。入力の質が出力の質を決める
  2. CI を整備する — テストが整っているリポジトリほど Coding Agent の恩恵が大きい
  3. スコープを小さく切る — 大きなタスクは人間が分解してからアサインする

定型的なタスク(バグ修正・テスト追加・軽微な機能追加)を Coding Agent に委任することで、エンジニアはより難しい設計や意思決定に集中できます。

まずは小さな Issue から試してみてください。設定は5分でできます。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?