CopilotコードレビューがCLAUDE.mdを読むように【複数AIの指示がぶつかる前に】
レビューAIが増えるほど、指示ファイルは「置けば安心」ではなくなります。
CopilotとClaudeのルールが衝突する前に、何を残し、どこを人が確認するかを一本の流れに整理しましょう。
GitHub Copilotのコードレビューが、Claude Code向けに置いたCLAUDE.mdも判断材料として読むようになりました。複数のAIを併用する会社にとって便利な変更ですが、古い指示やツール固有の命令まで同時に読まれる点には注意が必要です。
今やるべきことは、指示ファイルを増やすことではなく、共通ルールとツール固有ルールを分け、検証用PRで衝突を確かめることです。
そこで、設定ファイルの役割分担からマージ前の確認方法までを順に整理します。
要点CLAUDE.md対応後は指示の棚卸しが先
Copilot向けの新しい命令を足す前に、既存のCLAUDE.md、AGENTS.md、Copilot固有ファイルが同じ方向を向いているかを確認します。
CopilotコードレビューがCLAUDE.mdを読むようになった
2026年7月17日、GitHubはCopilot code reviewのカスタマイズ機能を更新しました。
リポジトリ内のCLAUDE.mdに加え、REVIEW.mdとGEMINI.mdも読み込み対象になったと公式Changelogで発表しています。
出典: GitHub Changelog「Copilot code review: Customization and configurability improvements」(英語)
同じ更新で、copilot-instructions.md、パス別の*.instructions.md、agent skills、AGENTS.mdは、プルリクエストで変更を含む側のhead branchから読むようになりました。
つまり、本流へマージする前に指示変更を試しやすくなったわけです。
AGENTS.mdへの対応自体は、その約1カ月前に進んでいました。GitHubは2026年6月18日、リポジトリルートに置かれたAGENTS.mdをCopilot code reviewが使う機能の一般提供を発表しています。
出典: GitHub Changelog「Copilot code review: AGENTS.md support and UI improvements」(英語)
読まれることと毎回従うことは別
ここで誤解しやすいのが、ファイルを置けば全命令へ必ず従うという考え方です。
GitHub公式チュートリアルは、AIの応答が非決定的であることを前提に、指示を短く具体的にし、ほかの指示と競合させないよう勧めています。
2026年6月12日には、.github配下のカスタム指示にあった4,000文字の読み取り上限が撤廃されました。
ただし、これは長文化を勧める変更ではなく、レビュー時に判定できる短い命令へ整える方が運用しやすくなります。
出典: GitHub Changelog「Copilot code review: New configurations and controls」(英語)
注意対象はGitHub上のCopilot code review
本記事の変更点を、Copilot CLIやすべてのIDEへそのまま一般化しないでください。機能ごとに対応する指示形式が異なるため、利用中の画面と公式対応表を確認します。
Copilotコードレビューの指示ファイルは役割で分ける
指示ファイルは、名前ではなく誰が、どの変更で使うルールかで分けます。
複数AIを併用するリポジトリでは、すべてをCLAUDE.mdへ寄せず、4つの層へ整理すると衝突を見つけやすくなります。
全AI共通
秘密情報、必須テスト、禁止操作など。AGENTS.mdまたは共通文書を正本にする。
Claude固有
Claude Codeの作業手順やセッション運用。CLAUDE.mdに残し、他AIが読んでも矛盾しない文へ整える。
Copilot固有
コードレビューだけで見る観点。copilot-instructions.mdへ置く。
パス固有
API、画面、テストなど対象を限定するルール。*.instructions.mdのapplyToで絞る。
ファイルごとの役割を表で確認する
| ファイル | 主な役割 | 置く内容 |
|---|---|---|
| AGENTS.md | 複数AIの共通ルール | 禁止操作、テスト、共通方針 |
| CLAUDE.md | Claude固有の作業指示 | Claude Codeの手順や参照先 |
| .github/copilot-instructions.md | Copilot共通 | コードレビュー固有の観点 |
| *.instructions.md | パス固有 | applyToで限定する技術ルール |
| REVIEW.md | 人とAIのレビュー観点 | 品質基準や確認項目 |
GitHub Docsは、AGENTS.mdをAIツールをまたぐ常設指示、copilot-instructions.mdをCopilot固有のリポジトリ共通指示として案内しています。
共通ルールを1カ所で管理し、ツール固有ファイルには差分だけ置くのが基本です。
出典: GitHub Docs「About GitHub Copilot code review」(英語)
ツール自体の役割も混同しない方が安全です。Claude Code・Codex・Copilotの使い分けを先に決めると、どのAIへ何を任せるかが明確になり、指示ファイルの境界も引きやすくなります。
CLAUDE.mdとAGENTS.mdがぶつかる場面
衝突は、難しい文章より日常的な短い命令で起きます。片方に「変更後は全テストを実行」、もう片方に「時間短縮のため単体テストだけ」と書かれていれば、レビュー基準が安定しません。
- テストコマンドがファイルごとに異なる
- 変更禁止範囲と自動修正対象が重なっている
- 対象パスが広すぎて別言語の変更へ適用される
- 出力形式が一方では詳細、他方では簡潔と指定される
- 古い構成や廃止コマンドがCLAUDE.mdに残っている
⚠ 衝突する設計
同じテストや禁止事項を複数ファイルへ複製し、それぞれ別の担当者が更新する。
VS
✓ 役割を分ける
共通ルールの正本を1カ所に決め、CLAUDE.mdとCopilot固有ファイルには差分だけ置く。
固定優先順位を前提にしない
Copilot code reviewについて、CLAUDE.md、AGENTS.md、Copilot固有ファイルが矛盾した場合の普遍的な優先順位は公式情報で確認できません。ファイル名から順位を想像する運用は避けます。
優先順位に頼る代わりに、意味が反対の命令をなくし、適用範囲を狭めます。
AIへ多く読ませるほど精度が上がるのではなく、判断に必要な基準だけが矛盾なく届く状態を目指してください。
回避同じ命令をコピーして強くしない
複数ファイルへの重複は命令の強化ではありません。更新漏れと矛盾を増やす原因になるため、正本と補足へ分けます。
Copilotコードレビューの指示を整理する手順
整理は、いきなり書き換えず一覧化から始めるのが安全です。既存ルールを消さずに役割を付け、意味が反対の命令だけを先に解消します。
棚卸し
全ファイルを確認
→
分類
共通と固有を分離
→
検証
PRで反応を見る
→
見直し
記録から更新
指示ファイルもコードと同じく変更と検証をくり返す
- CLAUDE.md、AGENTS.md、REVIEW.md、GEMINI.md、copilot-instructions.md、*.instructions.mdを一覧化する
- 各命令へ「全AI共通」「Claude固有」「Copilot固有」「パス固有」「人の運用」のラベルを付ける
- テスト、禁止操作、対象パス、出力形式で意味が反対の命令を探す
- 全AI共通ルールの正本を1カ所に決める
- Copilot固有のレビュー観点はcopilot-instructions.mdへ移す
- ディレクトリ固有の命令は*.instructions.mdへ分け、applyToを絞る
- 検証用PRで指摘漏れと誤検出を確認し、変更理由を記録する
短く判定可能な命令へ変える
「品質の高いコードにする」では、何を指摘すべきか判断できません。対象、条件、期待する指摘を1文へ入れ、判定できない抽象語を減らします。
たとえば、「認証情報がコードへ直書きされていたら指摘する」「API配下を変更したら指定のテストを確認する」のように書きます。外部URLだけを渡して読ませるのではなく、必要な判断基準を指示ファイル内へ残してください。
出典: GitHub Docs「Using custom instructions to unlock the power of Copilot code review」(英語)
組織全体のAI運用ルールと接続する場合は、AIエージェント利用の社内ルールも合わせて確認すると、コード上の禁止事項と会社の情報管理方針をそろえやすくなります。
Copilotコードレビューを検証用PRで試す
最新の公式発表でhead branchから読むと示されたのは、copilot-instructions.md、*.instructions.md、agent skills、AGENTS.mdの4点です。
CLAUDE.mdやREVIEW.mdも同じ扱いかは公式に明記がないため、指示の変更と小さなコード変更を同じ検証用PRへ入れ、実際の挙動をマージ前に確かめます。
ただし、2026年7月19日の調査時点では、一部GitHub Docsにbase branchを前提とした説明が残っています。
これは最新Changelogとの更新差とみられるため、現行判断では7月17日の変更発表を優先し、今後Docsが更新されたかも確認してください。
- 指示変更だけでなく、意図的な違反例を1〜3個入れる
- 期待した指摘が出たか、見逃しを記録する
- 関係ない変更への誤検出が増えていないか確認する
- 人のレビュー基準とCopilotの指摘が矛盾していないかを見る
- 結果が安定しない場合は、命令を短くして対象パスを狭める
補足検証は1回の成功で終わらせない
AIの指摘は毎回同一とは限りません。重要なルールは複数の小さなPRで再現性を確認し、人のレビュー結果も一緒に残します。
AIがどの作業をしたかまで追いたい場合は、GitHub Copilotエージェントの作業履歴を確認する方法も役立ちます。指示、PR、レビュー結果、作業ログをつなぐと、任せっぱなしを防ぎやすくなります。
AIレビューだけでマージしない
GitHubは、Copilot code reviewがすべての問題を見つける保証はないと説明しています。AIレビューは承認者ではなく、確認漏れを減らす補助者として置き、最終判断を人から外さないことが重要です。
とくに、認証、権限、課金、顧客データ、削除処理、外部公開に関わる変更は、人の確認を必須にします。AIで作ったコードのバグ検査で示したように、画面が動くことと安全に納品できることは同じではありません。
- 秘密情報がコードや指示ファイルへ入っていないか
- 権限変更が必要以上に広がっていないか
- 削除や公開など取り消しにくい処理が含まれないか
- 重要テストが実行され、結果を人が確認したか
- 指示ファイルの変更自体が別のAIへ影響しないか
入力データや参照範囲も別に管理が必要です。CopilotとClaudeを使う際のデータ権限管理を参考に、指示ファイルへ秘密情報を書かず、content exclusionなどの設定も確認してください。
指示ファイルを整える要点
Copilotコードレビューの指示設計とは、共通ルールとツール固有ルールを分け、検証用PRで矛盾を潰す運用です。
CLAUDE.mdが読み込み対象になった今、最初の一歩は新しい設定の追加ではなく、既存ファイルを一覧化して重複、矛盾、古いコマンドへ印を付けることです。
その結果をもとに正本を決め、Copilot固有とパス固有の命令を分離します。
複数AIを安全に使う基盤を広げるなら、指示ファイルだけでなくAIコーディングツールの役割分担も同時に見直します。ツールの役割とルールの置き場が一致すると、レビュー結果を説明しやすくなります。
CopilotコードレビューとCLAUDE.mdのよくある質問
QCopilot code reviewはCLAUDE.mdを読みますか？
Aはい。GitHubは2026年7月17日、Copilot code reviewがリポジトリ内のCLAUDE.md、REVIEW.md、GEMINI.mdを読むようになったと発表しました。
QCLAUDE.mdとAGENTS.mdはどちらを正本にすべきですか？
A複数AIで共有するルールはAGENTS.mdなどの共通文書、Claude固有の手順はCLAUDE.mdへ置く方法が実務的です。同じ命令を両方へ複製せず、正本を1カ所に決めます。
Qcopilot-instructions.mdは不要になりますか？
A不要にはなりません。Copilot固有のリポジトリ共通ルールはcopilot-instructions.md、対象パスが限定されるルールは*.instructions.mdへ置くと役割を分けられます。
Q複数の指示ファイルが矛盾した場合はどれが優先されますか？
ACopilot code reviewについて普遍的な優先順位を示す公式情報は確認できません。優先順位を想像せず、矛盾を除き、適用範囲を分けて検証用PRで確認します。
Q変更した指示をマージ前に試せますか？
A2026年7月17日の最新Changelogでは、対象のカスタム指示をhead branchから読むよう変更されています。指示変更と小さな違反例を検証用PRへ入れて確認できます。
QCopilotのレビューだけでマージしてよいですか？
Aいいえ。Copilot code reviewはすべての問題を検出する保証がありません。認証、権限、課金、顧客データ、削除、公開に関わる変更は人が確認します。
