Codex CLI Local Review：提交前让 Codex 审查改动

适用场景

在提交、推 PR 或合并前，可以让 Codex CLI 运行本地 review。它会用一个独立的 reviewer 视角检查你的改动，帮助发现逻辑漏洞、测试缺口、安全风险和无关修改。

这不是替代人工 review，而是提交前的额外检查。

Review 类型

官方 CLI features 页面提到几类 review：

| 类型 | 适合场景 | | --- | --- | | Review against a base branch | PR 前检查当前分支相对上游的 diff | | Review uncommitted changes | 提交前检查 staged、unstaged 和 untracked 改动 | | Review a commit | 审查一个指定 commit 的变更 | | Custom review instructions | 用自己的关注点审查，例如可访问性、安全或性能 |

步骤 1：准备干净上下文

先看工作区：

git status
git diff

如果包含很多无关改动，先拆分或暂存。Review 越聚焦，反馈越有价值。

步骤 2：在 CLI 中运行 review

进入 codex 交互式会话后，可以使用 review 相关 slash command，例如：

/review

然后按界面选择 review 类型。

如果你要检查未提交改动，选择 review uncommitted changes。
如果你要模拟 PR 审查，选择 review against a base branch。

步骤 3：加自定义关注点

对特定任务，建议补充 custom review instructions：

Focus on accessibility regressions, mobile layout overflow, and whether tests cover the changed behavior.

或者：

重点检查认证绕过、敏感信息泄漏和错误处理，不要泛泛而谈。

自定义指令能让 reviewer 更贴近你的真实验收标准。

步骤 4：处理结果

Review 结果会作为单独 turn 出现在 transcript 中。处理方式：

1. 先区分 confirmed issue、risk 和 suggestion。
2. 对高风险问题要求 Codex 给出证据。
3. 让 Codex 修复你确认的问题。
4. 重新运行测试。
5. 必要时重新 review。

示例：

请只修复 review 中 P1 的第一个问题，保持现有 API 不变。完成后运行相关测试。

常见错误

不要把 review 结果全部照单全收。建议类反馈仍然需要你判断。

不要在一个混乱 diff 上运行 review。先缩小改动范围。

不要让 review 代替测试。Review 能发现风险，但不能证明行为正确。

小结

Codex CLI local review 适合提交前做一次独立检查。好的流程是：整理 diff、运行 /review、提供自定义关注点、审查证据、只修复确认问题、重新验证。