指南約 9 分鐘

Codex Code Review 規則寫進 AGENTS.md(2026 年 7 月)

OpenAI 為 Codex Code Review 上線了倉庫自訂規則。把團隊反覆強調的檢查寫進 AGENTS.md — 審 PR 時 Codex 會引用它們。

2026 年 7 月,OpenAI 为 Codex 发布了自定义 Code Review 规则。重点不是又一个风格检查器,而是把通常只存在于少数 Reviewer 脑子里的判断写进仓库:不能破坏的 API 契约、必须保留给旧客户端的字段、绝不能进日志的数据。

变了什么

  • 同一份 AGENTS.md,多一份职责 — 指导编码任务的文件,现在也能指导 GitHub 审阅。
  • ## Code Review Rules — 单独一节;Codex 按变更文件应用规则,并在 finding 里引用。
  • 根目录 + 嵌套文件 — 仓库级规则放根;服务级规则放靠近代码的位置。
  • 触发 — PR 评论 @codex review,或在 Codex 设置里打开自动审阅。

一条就够本的最小规则

从 Reviewer 反复解释的那条开始。OpenAI 自家 Codex 仓库会保护 Cloud 仍在依赖的实验性事件名。你的版本可以是:

  • 写清不变量(什么必须一直成立)。
  • 给出安全路径(保留原名,或加向后兼容事件)。
  • 保持简短 — 太宽会产生噪音;收窄范围才能在干净 diff 上不乱报。

本周怎么试

  1. 为仓库启用 Codex cloud + Code Review。
  2. 在最近的 AGENTS.md 里 ## Code Review Rules 下加两三条规则。
  3. 开一个会触发规则的 PR、一个安全反例、一个无关改动。
  4. 评论 @codex review — 改掉嘈杂措辞,留下命中干净的规则。

和 Skills 怎么配合

规则与 Skills、MCP 并列:Skills 管「怎么做」;AGENTS.md 管「绝不能坏什么」。省额度见 免费试用;可安装 playbook 见更新后的 Skills 目录。官方说明:Custom Code Review rules for Codex

当 Agent 让 PR 暴增、审阅成瓶颈时,先把一条反复解释写进 AGENTS.md — 写一次,让 Codex 在每次 PR 上引用它。

更多指南

準備好和 Codex 一起工作了嗎?

在 ChatGPT 中開啟 Codex — 描述任務、審查交付物、改到滿意為止。免費方案可用。