一言で
Copilot Code Review は、Copilot を レビュアーとして手動・自動でアサインできる 機能。
アサインされた Copilot がコードの意図を読み、インラインコメント・PR 概要・修正提案を返してくれる。
💡 アナロジー:24/7 で待機している新人レビュアー。基礎的な指摘・スタイル・null 安全性は全部任せて、人間は 設計・ビジネスロジック・メンタリング に集中できる。
Copilot Code Review の強み
- 🧠 文脈を理解 — コードの意図を把握し、インラインコメント・PR 概要・修正提案を返す
- ⚙️ 自動化 — Repo / Org / Enterprise レベルで自動実行
- 📜 カスタマイズ —
copilot-instructions.md/AGENTS.mdでレビュー基準を定義 - 🔧 修正 — 指摘を 1 件ずつ、またはまとめて一括修正
- 🖥️ 快適な UI — VS Code / GitHub.com 上で提案された変更を diff ビュー でスムーズに確認・適用
- 🛡️ コンテンツ除外を尊重 — Repo / Org / Enterprise の Copilot コンテンツ除外パスに従い、機微・無関係なファイルをレビュー対象から除外
- 🔎 透明性 — Actions のログ・エージェントセッションですべて追跡可能
実績データ
日本を代表する 自動車業界・製造業 の顧客(2025 年 9 月〜 2026 年 2 月、PR Open Duration の中央値)。
💰 ビジネス価値:PR 承認 → マージまでの期間が短縮 ── 開発リードタイム が縮み、市場投入スピードが上がる。極めて高い ROI。
使い方
| 場所 | トリガー | 何が起きる |
|---|---|---|
| GitHub.com 手動レビュー | PR の Reviewers に Copilot を追加 | 数分後にインラインコメント + PR Overview が返ってくる(Draft PR でも Copilot 横の Request ボタンから即リクエスト可) |
| GitHub.com 自動レビュー | Repo / Org / Enterprise 設定で「PR 作成時に自動レビュー」を ON | すべての新規 PR が自動でレビューされる(3 ステップで Org 全体に展開可) |
| VS Code | Copilot: Review uncomitted changes を Source Control パネルから実行 | コミット前の変更にその場でレビュー → push 前にセルフチェック完了 |
| GitHub CLI | ターミナルで /review を実行 | 現在の作業ツリー / ブランチ差分をその場でレビュー — エディタを開かずに確認可能 |
| GitHub CLI (rubber duck) | 設計や実装方針を相談 → rubber-duck エージェントに壁打ち | 実装前に盲点・ロジック欠陥・代替案を指摘 → 手戻りを未然に防ぐ |
自動レビューのセットアップ
Ruleset で「PR 作成時に自動でレビュー」を有効化。Repo / Org / Enterprise の 3 レベルで適用範囲を選べる。
| スコープ | 設定パス | 主なオプション |
|---|---|---|
| リポジトリ | Repo → Settings → Code and automation → Rules → Rulesets → New branch ruleset | ✅ Automatically request Copilot code review ✅ Review new pushes ✅ Review draft pull requests |
| Organization | Org → Settings → Repository → Rulesets → New branch ruleset | リポジトリをパターンで一括対象(*-feature など) |
| Enterprise | Enterprise → Policies → Rulesets | 全 Org に強制適用 — ガバナンスを一元管理 |
📘 公式手順:Configure automatic code review — スクリーンショット付き
カスタマイズ
レビュー基準は リポジトリ内のファイルに書くだけ。Copilot Code Review が自動で読み込む。
| ソース | 場所 | 用途 |
|---|---|---|
copilot-instructions.md | .github/copilot-instructions.md | レビュー全体に効く基準(4000 文字の上限は撤廃、長文の詳細指示も全文反映) |
NAME.instructions.md | .github/instructions/ 配下 | applyTo で指定したパス・言語にだけ効く追加指示 |
AGENTS.md | リポジトリ ルート | 既存の AGENTS.md があれば自動で文脈として利用 — Cloud Agent / CLI と同じ規約を共有 |
💡 ポイント:既に
AGENTS.mdで運用しているなら、追加設定なしでレビューにも同じ規約が効く。AGENTS.md とは? ↗📘 公式手順:Adding repository custom instructions for GitHub Copilot — 3 種類のファイルと対応機能の一覧
ガバナンスとランナー制御
Copilot Code Review は エージェント型アーキテクチャで動作し、実体は GitHub Actions ランナー上で実行される(2026-06-01 以降 Actions 分を消費)。Org 管理者は実行環境を一元的に統制できる。
| 制御 | 設定パス | できること |
|---|---|---|
| ランナータイプ(Org) | Org → Copilot → Runner type → Runner type configuration | 全リポジトリ既定のランナー(標準 / 大型 / セルフホスト)を一括設定。ロックすれば個別リポジトリ設定を上書き。Code Review と Cloud Agent の両方に適用 |
| コンテンツ除外 | Repo / Org / Enterprise 設定(パスベースのルール) | 機微・無関係なファイル/ディレクトリをレビュー文脈から除外 |
🔧 ランナー環境の作り込み:サイズ拡張 / self-hosted / Windows への切替は
copilot-setup-steps.ymlで制御する。詳細は Cloud Agent ↗(Code Review と同じ仕組み)。
限界と人間の役割
Copilot Code Review は 強力だが万能ではない。次の領域は人間が引き続き担う:
- ビジネスロジックの正しさ ── 要件・仕様と照合する判断は AI には不可
- 深いセキュリティ分析 ── SAST / SCA は CodeQL など専用ツールと併用
- 設計レビュー ── アーキテクチャ・モジュール境界・トレードオフの議論
- メンタリング ── なぜそう書くべきかをチームメンバーに伝える
🎯 役割分担:AI が 基礎指摘・スタイル・null 安全性・テスト不足 を全部拾ってくれる分、人間は 設計・要件・育成 という付加価値の高い仕事に時間を使える。