SuperAPI AI 工具集

codex-review-workflow

编程与开发

查看项目

更新于 11-14 19:43

技能介绍

Codex Review Workflow 是一个代码审查技能,用于把 OpenAI Codex CLI 接入“实现—审查—修复—复查”的自动化闭环。它面向需要持续把关代码质量的开发场景,帮助在功能开发完成后自动获得审查反馈并迭代修正。\n\n用途与触发场景:当用户明确要求用 Codex CLI 审查代码(例如“用 Codex 审查这段”),或希望在实现后自动校验代码,或正在构建需要反复审查打磨的功能、需要满足特定质量标准时使用。若用户只想要人工审查、环境中没有 Codex CLI,或任务本身只是探索研究,则不应使用。\n\n主要流程:首先按常规最佳实践完成用户要求的功能或修复,并用 TodoWrite 跟踪“实现、初次审查、修复问题、最终审查、报告状态”等步骤;随后运行初次 Codex CLI 审查;再解析返回结果,区分缺陷与安全问题、质量改进建议、以及对已修复项的确认信息,提取文件名与行号等可执行信息;接着逐项修复问题并说明改动原因;之后再次调用 Codex CLI,针对此前具体问题做跟进复查;最后根据结果决定结束,或进入下一轮。\n\n审查执行方式:Codex CLI 没有 codex review 子命令,需用 exec 子命令配合详细的审查提示词,例如指定文件、审查缺陷、安全问题、最佳实践与改进点,并要求给出行号和示例;可用 -C 指定工作目录,用 -m 或 -c 指定模型与配置。CLI 要求工作目录为 git 仓库,否则需先 git init;也可用 --skip-git-repo-check 跳过检查,但不建议用于生产代码。复杂审查可能需要 30 至 120 秒,建议设置约 2 分钟超时。\n\n结果解析:Codex 输出为 Markdown,且格式变化较大。应重点识别 Bug、Security、Key Issues、Key Findings 等段落以及 High/Medium 严重级别项,这些必须修复;Maintainability、Suggestions 等属于较低优先级;复查时关注 Resolved Checks、No remaining findings、All issues resolved 等确认信号。遇到不熟悉的输出格式时,可参考技能内的 references/codex_output_formats.md。\n\n迭代限制:默认最多 2 轮审查(初次加一次复查),以避免死循环、保留人工判断空间,因为复杂问题可能需要架构调整。达到上限后,应总结已修复与遗留问题,展示最终输出,并询问用户是继续手工修复、调整方案还是接受当前状态。\n\n限制与注意事项:需提前确认 Codex CLI 已安装(which codex 或 codex --version);遇到认证错误可能需要先 codex login;出现 unexpected argument 时通常是把 exec 误用成了 review。Codex 反馈含糊时应向用户确认,不宜静默修改;修复时需保持原有功能不被破坏。该工作流可通过调整迭代上限、自定义命令、提供 Codex 规则配置、设定审查文件范围与严重级别阈值等方式定制。