指南约 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 — 描述任务、审查交付物、改到满意为止。免费计划可用。