用途:在提交代码前,用 OpenAI Codex CLI 的 codex review 命令对当前改动做 AI 代码审查,覆盖暂存、未暂存、未跟踪文件或与分支/提交的差异。
主要能力:先用 which codex 确认 CLI 是否安装;未安装时提示 npm install -g @openai/codex 或访问 https://github.com/openai/codex。按场景选择审查范围:默认 codex review 审查暂存改动;codex review --uncommitted 审查全部本地改动;codex review --base <branch> 审查相对分支的差异;codex review --commit <sha> 审查指定提交。用户未指定时,先看 git diff --cached --stat,有暂存改动就审查暂存内容,否则回退到 --uncommitted。
使用方式:审查提示词描述关注点,用户提供 $ARGUMENTS 时用作提示词,否则用默认提示如“review the changes for bugs, style issues, and potential improvements”。暂存改动(无标志)把提示词作为位置参数:codex review "<prompt>"。使用 --base、--commit 或 --uncommitted 时 CLI 不允许位置提示词,需通过 stdin 用 - 传入,例如 echo "<prompt>" | codex review --base <branch> -、echo "<prompt>" | codex review --uncommitted -、echo "<prompt>" | codex review --commit <sha> -。Bash 命令需设 10 分钟超时(600000ms),因为 codex 从 OpenAI API 流式返回,大 diff 可能耗时数分钟,默认 2 分钟会中途断开。审查完成后把完整输出保存到仓库根目录的 .codex-review-output.md。
结果处理:无问题则报告通过并继续;仅有次要建议则汇总给用户,由其决定是否处理;发现严重问题(缺陷、安全漏洞、逻辑错误)则清晰汇总,询问用户是否在继续前修复,若修复也不要提交,先交人工审查。
限制与排障:codex CLI 依赖 Node.js 运行时、OPENAI_API_KEY 环境变量和访问 OpenAI API 的网络。命令因环境失败时,依次检查 OPENAI_API_KEY 是否设置、尝试 --config model="gpt-5.2" 作为回退模型,仍失败则报告错误并跳过审查。通过 asdf/nvm 运行时,shim 路径可能需解析,可尝试 $(which codex) 或完整路径。其他细节暂未提供。