GitHub CopilotコードレビューでAGENTS.mdを使う方法｜2026年6月の公式更新

この記事でわかること

• 2026年6月18日に発表されたGitHub Copilotコードレビューの更新内容
• AGENTS.mdへ何を書けばよいか
• 初めて導入するときの配置方法と具体例
• 指示を増やしすぎないための注意点
• AIレビューだけに任せず、人が確認すべき範囲

結論・重要ポイント

1. GitHub Copilotコードレビューは、リポジトリ内のAGENTS.mdを参照してレビューできるようになりました。
2. 最初はリポジトリ直下へ1つ配置し、命名、テスト、エラー処理など重要なルールだけを書きます。
3. 指示は短く、具体的で、矛盾しない内容にします。長い説明や曖昧な要望は避けます。
4. AGENTS.mdはレビューの判断材料を増やす仕組みであり、すべての指示が毎回必ず反映される保証ではありません。
5. セキュリティ、仕様、業務判断を含む変更は、AIレビューの結果にかかわらず人が最終確認します。

対象読者と前提知識

この記事は、GitHubでコードを管理し、プルリクエストのレビューにGitHub Copilotを使っている方、または導入を検討している方向けです。

リポジトリがプロジェクトのファイルを管理する場所であり、プルリクエストが変更内容を確認して取り込む仕組みだと分かれば読み進められます。

MAO先生と学ぶAGENTS.md

コード・操作手順・具体例

1. リポジトリ直下へAGENTS.mdを作る

プロジェクトの最上位、README.mdやpackage.jsonなどがある階層へAGENTS.mdを作成します。

次は、JavaScriptやTypeScriptを使うWebプロジェクト向けの完全な設定例です。

# AGENTS.md

## コードレビューの重点項目

- ユーザー入力は利用前に検証する
- エラーを握りつぶさず、利用者向け表示と開発者向けログを分ける
- 既存の公開APIやURLを理由なく変更しない
- 不具合修正には、可能な限り再発防止テストを追加する

## JavaScript・TypeScript

- 変数名と関数名は処理の目的が分かる英語にする
- anyの追加は避け、必要な場合は理由をコメントで説明する
- 非同期処理では失敗時の処理を明示する

## 検証

- 変更した機能に関連するテストを実行する
- ビルドやテストを実行していない場合は、未実行であることを報告する

※AGENTS.mdの内容はプロジェクトによって変わります。利用していない言語や存在しないテストコマンドを、形式だけ合わせて書かないでください。

2. 重要なルールを具体的に書く

「安全なコードにする」のような抽象的な指示だけでは、何を確認すべきか判断しにくくなります。

曖昧な指示	具体的な指示
安全に実装する	ユーザー入力を利用前に検証する
きれいなコードにする	変数名と関数名で処理目的を表す
テストを大切にする	不具合修正には再発防止テストを追加する
互換性に注意する	既存の公開APIとURLを理由なく変更しない

3. 小さなプルリクエストで確認する

導入後は、いきなり大規模な変更で試すのではなく、小さなプルリクエストで次を確認します。

1. GitHub Copilotコードレビューを依頼する
2. AGENTS.mdに書いた観点の指摘が含まれるか確認する
3. 不要な指摘や不足している観点を記録する
4. 指示を短く修正する
5. 人のレビュー結果と比較する

GitHub公式ドキュメントでは、カスタム指示は短く、自己完結し、リポジトリに広く当てはまる内容にすることが推奨されています。

よくある誤解や失敗

AGENTS.mdを書けば必ず同じ指摘になる

AIの応答にはばらつきがあります。AGENTS.mdは判断材料ですが、決定的な静的解析ルールやテストの代わりではありません。必ず守らせたい規則は、リンター、型検査、自動テスト、CIでも確認します。

README.mdの内容をすべてコピーする

セットアップ手順、製品説明、長い背景情報までコピーすると、レビューで重要な指示が埋もれます。AIへ伝える必要がある開発規則だけを選びます。

存在しないコマンドを書く

実際には利用できないテストコマンドを書くと、レビューや作業報告が不正確になります。リポジトリで実行できるコマンドだけを記載してください。

矛盾するルールを残す

「既存形式を維持する」と「すべて新形式へ変更する」が同時に書かれていると判断できません。例外がある場合は、対象範囲と優先条件を具体的にします。

AIレビューだけでマージする

認証、権限、個人情報、決済、データ削除、公開APIの変更は影響が大きいため、人による確認が必要です。AIの指摘がないことは、安全性の証明ではありません。

Q&A

AGENTS.mdはどこへ置けばよいですか？

初めて導入する場合は、リポジトリ直下へ置くと分かりやすくなります。GitHub公式ドキュメントでは、複数のAGENTS.mdを配置した場合、対象ファイルに最も近い位置の指示が優先される仕組みも案内されています。まずは1つで運用し、必要になってから分割する方が管理しやすいでしょう。

GitHub Copilotコードレビュー以外でも使えますか？

GitHubはAGENTS.mdを、複数のAIエージェントで利用できるオープンな形式として案内しています。ただし、対応状況や読み取り方は製品ごとに異なるため、利用するツールの公式ドキュメントも確認してください。

どのようなルールから書くべきですか？

障害や手戻りにつながりやすい項目から始めます。入力検証、エラー処理、互換性、テスト、秘密情報の扱いなど、レビュー時に毎回確認したい項目が候補です。

指示ファイルがあればテストは不要ですか？

不要にはなりません。AGENTS.mdは文章による指示です。実際の動作は、自動テスト、ビルド、型検査、ブラウザ確認などで検証します。

要点まとめ

• 2026年6月18日から、GitHub CopilotコードレビューはAGENTS.mdの指示を利用できるようになった
• 最初はリポジトリ直下へ1つ配置する
• 指示は短く、具体的で、矛盾しない内容にする
• AIのレビュー結果にはばらつきがあるため、リンターやテストも併用する
• 影響の大きい変更は人が最終確認する

公式資料・参考資料

• GitHub Changelog: Copilot code review now supports AGENTS.md custom instructions
• GitHub Docs: Adding repository custom instructions for GitHub Copilot
• AGENTS.md公式サイト

※公式情報を2026年6月21日に確認して作成しています。機能の提供条件や対応範囲は変更される可能性があるため、利用時点の公式情報も確認してください。

GitHubやAIコードレビューの導入を相談できます

AGENTS.mdを作る前に、現在の開発ルールやレビュー観点を整理することが重要です。

MAO工房では、GitHubの初期設定、リポジトリ運用、AIコーディングツールへ渡す指示の整理まで、利用状況に合わせて支援します。お問い合わせフォームから、困っている範囲をお知らせください。