用途:对当前分支改动或计划做跨模型外部评审,由 Codex 担任评审者,并用退出码机械执行其结论,避免本会话自行推翻 CRITICAL/IMPORTANT 判定。
主要能力:Codex 按 sev.schema.json 输出结构化 JSON 而非散文,门禁由 priority 计算;脚本以退出码决定通过与否;评审在 workspace-write 沙箱中运行,可实际执行类型检查与测试;门禁对工作树与 HEAD 做前后指纹,评审者若改动代码则判为 INFRA。
使用方式: .claude/skills/codex-review/codex-review.sh 支持 --base origin/main、--staged、--worktree、--plan <文件> --focus "..."、--block-at 2 等参数。退出码:0 CLEAN、1 FINDINGS、2 INFRA、3 USAGE;原始 JSON 写入 --out(默认 /tmp/codex-review.json)。建议按风险设定轮次预算,收敛时可加一轮,硬上限 6 轮。
适用场景:计划/规格评审(--plan)、TDD 后合并或部署前的 diff 评审;琐碎、纯文档、纯测试或机械重命名改动不建议评审。
限制:INFRA 不等于通过,不可进入修复循环;只读模式无法运行 Vitest,会退化为静态评审;Ubuntu 24.04 上需 unshare -U -r echo ok 输出 ok;单评审者通过不等于正确,非平凡 PR 建议另做多评审者检查;本技能文件不应出现在被评审的 diff 中。它不替代 typecheck、test、test:security、deploy.sh 等确定性门禁。