実践ワークフロー
GitHub Copilotの各機能を組み合わせた実践的な開発ワークフロー。Issue起点の自動化からマルチツール運用まで、現場で即使えるパターンを紹介します。
Issue→PR自動化
GitHub Issueを起点に、Coding Agentが自動でブランチ作成からPR作成までを行うワークフローです。定型的なバグ修正や機能追加に特に有効です。
Issueを作成
修正内容や機能要件を明確に記述したIssueを作成します。受け入れ条件やテストケースを含めるとエージェントの精度が向上します。
@copilot をアサイン
IssueのAssigneesに @copilot を追加します。Coding Agentが自動的にタスクを開始します。
エージェントがブランチ作成・実装
エージェントが新しいブランチを作成し、コードの変更を実装します。ファイルの読み取り、編集、新規作成を自律的に行います。
テスト実行・セルフレビュー
エージェントが自分でテストを実行し、結果を確認します。エラーがあれば自動的に修正を試みます。
ドラフトPR作成
実装とテストが完了すると、ドラフトPRを自動作成します。変更内容のサマリーとIssueへのリンクが含まれます。
人間がレビュー・マージ
開発者がPRをレビューし、問題がなければマージします。修正が必要な場合はPRにコメントすると、エージェントが追加修正を行います。
Issueの記述が具体的であるほど、エージェントの出力品質が向上します。「ボタンの色を変えて」よりも「src/components/Button.tsx の primary variant の背景色を #3b82f6 から #2563eb に変更し、ホバー時は #1d4ed8 にする」のように具体的に書きましょう。
チーム実務ワークフロー
チームでCopilotを活用する際の標準的な3ステップワークフローです。
Plan(計画)
Copilot Chatの Plan モードで要件と制約を渡し、実装計画を作成・合意します。事前に方針を固めることで、手戻りを最小化します。
Edit / Agent(実装)
Agent モードで複数ファイル実装を委任、またはEdit モードで対象を絞って安全に編集します。NES(Next Edit Suggestions)で波及修正も自動提案されます。
Code Review(レビュー)
AI生成コードにはセキュリティリスクが含まれる可能性があります。最終的なビジネスロジックと脆弱性のチェックは必ず人間が実施してください。
CI/CDでCoding AgentやCLIを使う場合、マージや本番デプロイの完全自動化(無人運転)は厳禁です。必ず人手による承認(Approve)ゲートを設けてください。
Agent Modeでの開発
VS Code内のCopilot ChatでAgent Modeを使用した、対話型のエージェント開発フローです。
-
Agent Modeを起動
VS CodeのCopilot Chatパネルを開き、モード選択で「Agent」を選択します。 -
タスクを自然言語で指示
「ユーザー認証機能を追加して。JWT tokenを使って、ログイン・ログアウト・トークンリフレッシュのAPIを作成して」のように指示します。 -
エージェントが自律実行
エージェントがファイルの読み書き、ターミナルコマンドの実行、パッケージのインストールなどを自律的に行います。各操作の前に承認を求められます。 -
結果を確認・修正指示
生成されたコードを確認し、追加の修正が必要な場合は対話で指示します。「テストも追加して」「エラーハンドリングを改善して」など。
# 良い指示の例
「src/api/auth.ts にJWT認証のミドルウェアを作成して。
- access tokenは15分、refresh tokenは7日で期限切れ
- bcryptでパスワードハッシュ化
- 既存のUserモデル(src/models/user.ts)を使用
- テストも書いて(vitest)」
# 悪い指示の例
「認証を作って」Agent Modeは操作の承認を段階的に行えます。全ての操作を手動承認するか、特定のコマンドを自動承認リストに追加するか、設定で制御できます。セキュリティとスピードのバランスを調整しましょう。
CLIバックグラウンド
Copilot CLIのバックグラウンド実行機能を使えば、エージェントにタスクを任せつつ、別の作業を続けられます。
# バックグラウンドでユニットテストを追加
copilot "src/utils/ 配下の全関数にユニットテストを追加して" &
# バックグラウンドでドキュメント生成
copilot "全てのexport関数にJSDocコメントを追加して" &
# 実行中のタスク一覧を確認
copilot tasks
# 完了したタスクの結果をレビュー
copilot tasks show <task-id>バックグラウンドタスクの完了後、変更内容をレビューし、問題がなければコミットします。複数のタスクを並行して実行することも可能です。
バックグラウンドタスクは同じリポジトリ内で競合する変更を行う可能性があります。関連性の低いタスクを並行実行し、完了後にコンフリクトがないか確認してください。
Handoffパターン
Copilot CLIでの調査・探索をCoding Agent(Cloud)に引き継ぐ「ハンドオフ」パターンです。ローカルの知見をクラウドエージェントに委任して、PRの作成まで自動化します。
-
CLIで探索・調査
Copilot CLIを使ってコードベースを探索し、問題の原因を特定します。「このバグの原因を調査して」と指示します。 -
/delegate でCloud Agentに委任
原因が判明したら、/delegateコマンドでCoding Agent(Cloud)にタスクを引き継ぎます。CLIでの調査結果がコンテキストとして渡されます。 -
Cloud AgentがPR作成
Coding Agentがブランチ作成、実装、テスト、PR作成を自動で行います。
# 1. CLIで調査
copilot "src/api/users.ts で500エラーが発生する原因を調べて"
# 2. 原因特定後、Cloud Agentに委任
/delegate "src/api/users.ts の getUserById 関数で
null チェックが不足している問題を修正して。
テストも追加してPRを作成して"Handoffパターンは「人間が方向を決め、AIが実装する」という分業を実現します。特に複雑なバグ修正で、原因調査は人間(+CLI)が行い、修正実装はCloud Agentに任せる場合に有効です。
Workspace活用
GitHub.comのWorkspace機能を活用し、ブラウザ上で完結する開発ワークフローです。
-
IssueをWorkspaceで開く
GitHub.comでIssueを選択し、Copilot Workspaceで開きます。エージェントがIssueの内容を分析し、実装計画を提示します。 -
AI計画をレビュー
エージェントが提示した変更計画(どのファイルをどう変更するか)をレビューします。必要に応じて計画を修正できます。 -
実装を実行
計画を承認すると、エージェントが実装を開始します。進行状況をリアルタイムで確認できます。 -
Codespaceでテスト
ワンクリックでCodespaceを起動し、生成されたコードをテスト・動作確認します。 -
PRを作成
テストが通ったら、Workspaceから直接PRを作成します。
Copilot WorkspaceはGitHub.comのブラウザ上で動作するため、ローカル環境のセットアップが不要です。新しいチームメンバーのオンボーディングや、軽微な修正に特に便利です。
マルチツール運用
2026年の調査によると、AIコーディングツールの経験者は平均2.3ツールを併用しています。GitHub Copilot、Claude Code、OpenAI Codexなど、各ツールの強みを活かしたマルチツール運用が効果的です。
| ツール | 得意領域 | 推奨用途 |
|---|---|---|
| GitHub Copilot (Inline) | リアルタイム補完 | 日常的なコーディング、小さな関数、定型コード |
| Copilot Agent Mode | VS Code統合エージェント | 中規模の機能実装、ファイル横断の変更 |
| Copilot Coding Agent | Issue→PR自動化 | 定型的なバグ修正、テスト追加、ドキュメント更新 |
| Claude Code | 大規模リファクタリング | アーキテクチャ変更、複雑な問題分析、長いコンテキスト |
| OpenAI Codex | 並列自動化 | 複数タスクの同時実行、バッチ処理的な変更 |
運用パターン例
- 日常コーディング — Copilot Inlineで補完を受けながらコーディング。複雑な部分はAgent Modeに切り替え
- バグ修正 — Issueに
@copilotをアサインして自動修正。複雑なバグはCLI + Handoffパターン - 大規模リファクタ — Claude Codeで計画と実装。Copilotでテスト追加を補助
- 並列作業 — Codexで複数リポジトリのCI修正を同時実行。Copilot Coding Agentで個別のIssueを処理
ツールの使い分けに正解はありません。チームの技術スタックや開発スタイルに合わせて、最も効率的な組み合わせを見つけましょう。重要なのは「全てを1つのツールで行おうとしない」ことです。
Claude Code風の最強環境を構築する
Claude Codeの強み(深い推論、大規模リファクタリング、自律ターミナル操作)をCopilotエコシステム内で再現する方法を、4つのステップで解説します。
Step 1: Copilot CLIをClaude Code化
# Copilot CLIインストール
npm install -g @github/copilot
copilot login
# セッション内でClaudeモデルに切り替え
/model claude-opus-4-6Planモード(Shift+Tab)で計画→承認→実行のフローは、Claude Codeの「Explore→Plan→Implement」と同じ思考プロセスです。
Step 2: AGENTS.mdでClaude風の深い指示を設定
### Core Principles
- MUST: 必ずPlanモードで計画を立ててから実装する
- MUST: テストを書いてから実装する(TDD)
- NEVER: 確認なしで本番環境に影響する操作をしない
### Self-Improvement
ミスが発生したら、このファイルのLessons Learnedセクションに追記するStep 3: MCPで外部ツール接続
# Playwright(ブラウザ操作)
npx playwright mcp
# GitHub MCP(Issue/PR操作)
# VS Code設定で有効化Step 4: カスタムエージェントで専門化
---
description: コードレビュー専門エージェント
tools:
- codebase
- diffs
prompt: |
変更されたファイルを読み、以下の観点でレビューする:
- バグの可能性
- セキュリティ問題
- パフォーマンス問題
---なぜCopilot + Claudeモデルが「上位互換」になるか
| 機能 | Claude Code単体 | Copilot + Claudeモデル |
|---|---|---|
| Claudeの推論力 | ✅ | ✅(同じモデル) |
| IDE統合 | ❌(ターミナルのみ) | ✅(VS Code完全統合) |
| インライン補完 | ❌ | ✅ |
| マルチモデル切替 | ❌ | ✅(GPT/Geminiも選択可) |
| GitHub連携 | 外部ツール | ネイティブ統合 |
| Spaces | ❌ | ✅ |
| Coding Agent | ❌ | ✅(Issue→PR自動化) |
既存Claude Codeユーザーへ: CLAUDE.md の内容を AGENTS.md にコピーするだけで移行完了。構造はほぼ同一です(比較は「カスタム指示 > Claude Codeからの移行ガイド」を参照)。
Spec-Kitで仕様駆動開発
GitHub公式のSpec-Kitツールキットで、「なんとなくプロンプト(vibe coding)」から「仕様駆動開発(Spec-Driven Development)」に完全移行できます。
導入手順
# Spec-Kit初期化
specify initワークフロー
-
自然言語で要件を入力
作りたいものを自然言語で記述します。技術的な詳細は不要です。 -
AIが対話的に
.specify(詳細仕様書)を作成
AIが質問を通じて要件を明確化し、構造化された仕様書を生成します。 -
/speckit.planでアーキテクチャ決定
仕様書をもとに、技術スタックやアーキテクチャの計画を策定します。 -
/speckit.tasksでタスク分解
計画を実装可能な粒度のタスクに自動分解します。 -
各タスクを自動実装
分解されたタスクをエージェントが順次実装します。
なぜSpec-Kitが強力か
- 仕様書がSingle Source of Truth(唯一の真実)になる — チーム全員が同じ仕様を参照し、認識齟齬を防止
- 「何を作るか」が明確なため、AIの出力精度が劇的向上 — 曖昧なプロンプトによる手戻りを排除
- テスト仕様も同時生成されるため品質保証が容易 — 仕様と実装とテストが一貫
- チームメンバー全員が同じ仕様を参照 — オンボーディングやレビューの効率が大幅改善
vibe coding(なんとなくプロンプト)からの脱却。Spec-Kitを使えば、仕様→計画→タスク→実装の一貫したフローで、手戻りと認識齟齬を大幅に削減できます。
指示ファイルの使い分け早見表
| ファイル種別 | 配置場所 | 主な適用機能 | 強み | 推奨用途 |
|---|---|---|---|---|
copilot-instructions.md |
.github/ |
Chat / Code Review / Agent | リポジトリ全体の恒久ルール | コーディング規約・ビルド手順 |
AGENTS.md |
任意(近接優先) | Coding Agent / Agent Mode | エージェント専門家化・教訓記憶 | Lessons Learned / Boundaries |
SKILL.md (Skills) |
.github/skills/xxx/ |
Agent Mode / CLI | オンデマンド専門スキル | デバッグ手順・E2Eテスト |
*.instructions.md |
.github/instructions/ |
Chat / Coding Agent / Review | パス固有の細分化ルール | 特定フォルダ・ファイル種別 |
公式推奨: AGENTS.md + Skillsの併用でCI失敗率70%減、PRレビュー時間半減の報告あり。まずはAGENTS.md作成から始め、頻出パターンをSkillsに切り出していくのが最適な導入順序です。