ガイド約 9 分

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 を荒らさない。

今週の試し方

  1. リポジトリで Codex cloud + Code Review を有効化。
  2. 最も近い AGENTS.md の ## Code Review Rules にルールを2〜3本追加。
  3. ルールに引っかかる PR、安全な反例、無関係な変更を用意。
  4. @codex review を依頼 — ノイズな文言を直し、きれいに当たるルールを残す。

Skills との関係

ルールは Skills と MCP と並びます。Skills はどうやるか、AGENTS.md は壊してはいけないもの。無料枠の節約は Try Codex、インストール可能な playbook は更新済みの Skills ディレクトリ。公式記事:Custom Code Review rules for Codex

エージェントで PR が増えレビューがボトルネックなら、繰り返し説明している一点を AGENTS.md に一度書いて、Codex に毎回の PR で引用させましょう。

関連ガイド

Codex と一緒に仕事を始める準備はできましたか?

ChatGPT で Codex を開く — タスクを記述し、成果物を確認し、納得いくまで改善。無料プランあり。