用途:在 git push 非平凡改动前,本地复现 CI 的 Codex PR 审查,提前发现 CI 会标记的问题。
与 CI 一致的部分:策略用 REVIEW.md,涵盖严重性分级、公开接口检查、AGENTS.md 合规与测试覆盖;模型为 gpt-6.1-sol;推理强度 model_reasoning_effort="xhigh";输出为 markdown,以 ## Codex Review 开头,发现项标注 P0/P1/P2 并带 file:line。
与 CI 的差异:范围是当前分支与 main 在合并基点的差异,并包含未提交改动;沙箱为只读,Codex 只读 diff 与文件,不能修改工作区;codex exec 为独立冷启动进程,不依赖当前会话上下文。
前置条件:需安装并认证 codex CLI >= 0.159.3(codex login 或环境变量 OPENAI_API_KEY,后者优先)。旧版本会拒绝该模型,run.sh 会先检查版本。可通过 npm install --global @openai/codex@0.159.3 升级(全局安装可能需 sudo),与 CI 工作流中的固定版本一致。若基线引用过旧,先执行 git fetch。
用法: bash .agents/skills/local-review-codex/run.sh bash .agents/skills/local-review-codex/run.sh <base> 默认对比 main;若 main 不是本地分支,自动回退到 origin/main。必须用 bash(脚本依赖 set -o pipefail,sh 在 Debian/Ubuntu 上是 Dash,会失败)。脚本计算 BASE_SHA = git merge-base HEAD <base>,将 REVIEW.md 与指向 git diff <BASE_SHA> 的上下文交给 Codex,并打印审查结果;只写临时文件,不落工作区。
结果传递:应原样打印 Codex 输出,不要重新总结或过滤,再与用户决定是否在推送前处理发现项。如需 Claude 原生审查,可用 local-review 的 branch-diff-reviewer 子代理;本技能是其 Codex 对应版本,可同时运行以获得独立视角。