promptgarten 🌱

命令参考 · Codex CLI

codex review

通过 CLI 对改动执行 Review。

codex review 通过命令行非交互式地执行代码审查,也就是说不会打开一个正在运行的 TUI 会话。 根据文档,你需要恰好选择一个审查目标:--uncommitted(已暂存、未暂存以及未跟踪的改动)、--base <branch>(与某个基准分支的差异)、--commit <SHA>(某个特定提交的改动),或者以自由文本形式给出自己的审查指令 PROMPT(也可用 - 从 stdin 读取)——根据文档,这些选项彼此互斥。--title 用于设置审查摘要中显示的提交标题,但只有配合 --commit 使用时才生效。此外还有 --strict-config,当 config.toml 中包含未知字段时会触发报错。需要与独立的 codex review 调用区分开的是斜杠命令 /review,根据 Codex 源码,它是在已经运行中的交互式会话内使用的,同样可以接受内联参数作为指令。

什么时候用?

提交前审查未提交的改动

codex review --uncommitted

审查带标题的特定提交

codex review --commit a1b2c3d --title "修复登录 Bug"

什么时候不该用?

同时指定多个审查目标

根据文档,--uncommitted、--base、--commit 和自定义的 PROMPT 彼此互斥——只允许选择一个选项。

更好的选择: 只选择一个目标选项,例如仅使用 --base main

希望审查是正在进行的交互式会话的一部分

codex review 是一个独立的、非交互式的 CLI 调用,在运行中的 TUI 会话之外执行。

更好的选择: 在运行中的会话内改用 /review

来源

更多命令 · Codex CLI

codex resumecodex apply/init/compact/reasoning/fast/personality/memories/ide/feedback/approve/side

全部命令 · Codex CLI

分享:𝕏in💬