SuperAPI AI 工具集

codex-review

编程与开发

查看项目

更新于 10-15 23:42

技能介绍

用途:在动手编码前,用 Codex 作为独立审查者检查非平凡的设计文档或实现计划,再由 Claude 对照仓库与用户需求验证每条反馈并决定是否修改。

触发规则:起草或大幅修改计划后自动运行,适用于多文件实现、新功能、重构、迁移、发布、架构决策,以及安全、认证、权限、支付、计费、schema、数据处理、并发、性能敏感代码或依赖变更。琐碎工作(错别字、小文案、简单配置、纯文档、无 API/数据流影响的单文件小工具)先询问;用户明确要求跳过时不运行。

使用方式:计划必须先保存为文件,并包含具体仓库细节(文件路径、模块、函数、命令、测试、迁移步骤、约束、非目标)。确定 PROJECT_ROOT 与 PLAN_PATH 绝对路径,清除密钥与隐私数据。通过 Bash 工具前台运行 codex exec,超时设为 1200000,使用 --sandbox read-only、--skip-git-repo-check、--ephemeral,并把计划内容用 $(cat "$PLAN_PATH") 内联进提示词,而非让 Codex 按路径读取。

反馈处理:逐条验证文件、符号、路由、命令、测试、schema、依赖是否真实存在,判断其属于 Critical、Important、Optional 还是无效/超范围。Critical 立即修计划;Important 低风险可直接应用,否则询问;Optional 询问或仅作建议;无效反馈忽略。修改应直接改原计划文件,不另建反馈文件。非关键选择尽量合并为一个问题并附跳过选项。

轮次与失败处理:默认最多 3 轮,仅在修复了有效 Critical 问题后重跑;无有效 Critical 即停止。若 codex exec 失败、超时或无可用输出,重试一次,仍失败则询问用户跳过、重试或停止,不得声称已完成审查。

限制:Codex 只读、不得改文件;不要后台运行;不要用 --full-auto 或把 --ask-for-approval 放在 exec 之后;不要自动应用可选偏好;对无法访问的外部系统或全新项目,反馈可能较浅。