AGENTS.md の Codex Code Review ルール(2026年7月)
OpenAI が Codex Code Review 向けのリポジトリカスタムルールを公開。チームが繰り返し説明するチェックを AGENTS.md に書き、PR で Codex に引用させます。
2026年7月、OpenAI は Codex 向けにカスタム Code Review ルールを公開しました。単なるスタイルリンタではなく、一部のレビュアーの頭の中にあった判断をリポジトリに書く仕組みです — 壊してはいけない API 契約、古いクライアント向けに残すフィールド、ログに出してはいけないデータなど。
何が変わったか
- 同じ AGENTS.md、新しい役割 — コーディング指示のファイルが GitHub レビューも導けます。
- ## Code Review Rules — 専用セクションを追加。Codex は変更ファイルに該当するルールを適用し、finding で引用します。
- ルート + ネスト — リポジトリ全体はルート、サービス固有は対象コードの近くに。
- トリガー — PR で
@codex review、または Codex 設定で自動レビューを有効化。
元が取れる最小ルール
レビュアーが何度も説明するチェックから始めます。OpenAI 自身の Codex リポジトリは、Cloud 消費者がまだ依存する実験的なイベント名を保護しています。あなたの版は例えば:
- 不変条件を述べる(何が常に真でなければならないか)。
- 安全な経路を示す(名前を維持、または後方互換イベントを追加)。
- 短く保つ — 広すぎるルールはノイズ、範囲を絞るとクリーンな diff を荒らさない。
今週の試し方
- リポジトリで Codex cloud + Code Review を有効化。
- 最も近い AGENTS.md の
## Code Review Rulesにルールを2〜3本追加。 - ルールに引っかかる PR、安全な反例、無関係な変更を用意。
@codex reviewを依頼 — ノイズな文言を直し、きれいに当たるルールを残す。
Skills との関係
ルールは Skills と MCP と並びます。Skills はどうやるか、AGENTS.md は壊してはいけないもの。無料枠の節約は Try Codex、インストール可能な playbook は更新済みの Skills ディレクトリ。公式記事:Custom Code Review rules for Codex。
エージェントで PR が増えレビューがボトルネックなら、繰り返し説明している一点を AGENTS.md に一度書いて、Codex に毎回の PR で引用させましょう。