◀ 用語一覧
NO.09

Copilot Code Review

更新: 2026.07.22

一言で

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 の オープン期間 (日)
Copilot Code Review なし Copilot Code Review あり
14.2 日
11.6 日
自動車業界の顧客
13.6 日
11.1 日
製造業界の顧客

💰 ビジネス価値:PR 承認 → マージまでの期間が短縮 ── 開発リードタイム が縮み、市場投入スピードが上がる。極めて高い ROI。

使い方

場所トリガー何が起きる
GitHub.com 手動レビューPR の ReviewersCopilot を追加数分後にインラインコメント + PR Overview が返ってくる(Draft PR でも Copilot 横の Request ボタンから即リクエスト可)
GitHub.com 自動レビューRepo / Org / Enterprise 設定で「PR 作成時に自動レビュー」を ONすべての新規 PR が自動でレビューされる(3 ステップで Org 全体に展開可)
VS CodeCopilot: Review uncomitted changes を Source Control パネルから実行コミット前の変更にその場でレビュー → push 前にセルフチェック完了
GitHub CLIターミナルで /review を実行現在の作業ツリー / ブランチ差分をその場でレビュー — エディタを開かずに確認可能
GitHub CLI (rubber duck)設計や実装方針を相談 → rubber-duck エージェントに壁打ち実装前に盲点・ロジック欠陥・代替案を指摘 → 手戻りを未然に防ぐ

自動レビューのセットアップ

Ruleset で「PR 作成時に自動でレビュー」を有効化。Repo / Org / Enterprise の 3 レベルで適用範囲を選べる。

スコープ設定パス主なオプション
リポジトリRepo → SettingsCode and automationRulesRulesetsNew branch ruleset✅ Automatically request Copilot code review
✅ Review new pushes
✅ Review draft pull requests
OrganizationOrg → SettingsRepositoryRulesetsNew branch rulesetリポジトリをパターンで一括対象(*-feature など)
EnterpriseEnterprise → PoliciesRulesets全 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 → CopilotRunner typeRunner 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 安全性・テスト不足 を全部拾ってくれる分、人間は 設計・要件・育成 という付加価値の高い仕事に時間を使える。