SuperAPI AI 工具集

codex-review

编程与开发

查看项目

更新于 11-15 16:06

技能介绍

codex-review 是一个基于 Codex CLI 的双模型代码审查技能,来自 suyuan2022/suyuan-skill。

一、用途与角色 该技能用于对代码进行多模型交叉审查,以减少单模型审查的遗漏与误报。流程中,Codex 侧的两个模型(资料中示例为 GPT-5.4 与 GPT-5.2)作为两个独立审查者,同时检查同一份代码且互不知晓对方结果;Claude 作为控制者与仲裁者,负责构造提示词、并行派发两个模型、对比发现、裁决分歧并做最终决定。

二、前置条件 使用前需安装并认证 Codex CLI:npm install -g @openai/codex 然后 codex login。同时需要一个可访问 GPT-5.4 与 GPT-5.2 的 OpenAI 账号,或按需调整命令中的模型名称。资料未提供其他收费、价格或平台信息。

三、主要模式 技能按用户信号选择模式:review/check/look at 触发 review(只读沙箱);fix/modify/let Codex fix 触发 fix(workspace-write 沙箱);security audit/OWASP/full scan 触发 audit(只读);autopilot/unattended/long-running 触发 autopilot(只读);不明确时默认 review。autopilot 模式不是默认行为,需要用户明确要求;在该模式下,Claude 依据 PRD 文档、现有代码行为做仲裁,自行决定是否修复,仅将涉及产品方向或业务权衡的待确认项批量留到最后报告。

四、并行审查与仲裁 每次审查通过 Bash 并行发起两个 codex exec 调用,使用相同提示词但不同模型,分别输出到临时文件;fix 模式仅由一个模型(默认 Model A)执行修复,但审查阶段仍使用两个模型。两个结果返回后,Claude 按三个区域处理:共识区(两模型均标记,直接采纳)、单来源区(阅读代码验证,硬证据采纳,软证据降级为建议,误报则丢弃并说明理由)、冲突区(阅读代码裁决,无法解决则升级给用户)。输出时按 [A+B]、[A]、[B]、[Conflict→Claude] 标注来源。

五、提示词与迭代机制 发给 Codex 的提示词采用固定 XML 块结构,包括 task、context、instructions、grounding_rules、verification_loop、dig_deeper_nudge、review_coverage、verdict、default_follow_through_policy、action_safety 等,并按模式选择必含块。复审时要求提供“修复证据索引”,按 file:line 粒度列出 Finding→修复位置→理由,并要求 Codex 独立读取代码验证而非复述理由。审查-修复循环最多 3 轮,超过后停止并报告用户。每次审查后向用户报告两个会话 ID,支持通过 codex exec resume SESSION_ID 续接会话。

六、适用场景与限制 适用于新功能(涉及 2 个以上文件或新函数)、重构、复杂缺陷修复、高风险场景及用户明确要求审查的场合;拼写、命名、注释、单行简单修复、格式调整或用户要求快速处理时可跳过。调用时 -C 需指向当前工作目录,提示词中不嵌入文件内容而只给绝对路径,一次性审查用 --ephemeral,非 git 目录用 --skip-git-repo-check。资料未提供性能数据或效果保证。