SuperAPI AI 工具集

build-loop-codex

编程与开发

查看项目

更新于 10-15 17:30

技能介绍

用途:在使用 Codex(OpenAI Codex CLI)开发功能时,强制走一条有质量门禁的构建循环:构建 → 审查 → 端到端测试 → 修复,未通过不推进。

工作来源:若仓库中存在计划文件(路线图、重构计划或带 - [ ] 复选框的任务列表),先做第一个未勾选任务,任务顺序有意为之,不得跳步;计划引用规格文档时只读与当前任务相关的章节。没有计划或请求超出计划范围时,依据用户提示构建,先将其复述为可验证目标,给出 2–4 条成功标准,并在一条消息中确认范围后再动手。

循环步骤:构建时严格实现任务所要求的内容,采用满足需求的最简实现,改动精准,不做投机性扩展,遵循项目既有约定。审查时运行 /review 并选择“Review uncommitted changes”;若改动涉及认证、支付、用户输入或数据访问,再通过“Custom review instructions”做第二轮(例如“Focus on security vulnerabilities and unvalidated input”)。修复范围内所有发现的问题,包括缺陷、安全问题、边界情况、性能和你所改文件的风格;若项目有设计系统规范(设计令牌文件、DESIGN.md、主题配置),UI 改动需对照检查,不得硬编码颜色、字体或间距绕过令牌。未触及代码中的既有问题记录到报告中,不静默修复。重复 /review 直到干净;若发现与任务或规格冲突,以规格为准并指出分歧。

测试:运行任务的验证步骤或成功标准,跑完整测试套件,确保此前通过的仍通过,为新逻辑补测试;再以用户身份走真实流程,覆盖空、加载和错误状态。修复:测试发现的问题回到循环,修复 → /review → 重测;失败任务不得标记完成,应用损坏时不得开始下一任务。继续:将任务标记为 - [x],更新计划中的进度/状态行,循环至请求范围完成。报告:说明构建内容与计划进度、已修复与延期的审查发现、验证方式(测试与流程走查),以及需要用户关注的事项;对不稳定或仅部分验证的内容如实说明。

规则:跳过审查或未测试的工作视为未完成;不重新争论计划决策,若任务看似有误,提一个具体问题而非猜测;发现无任务覆盖的工作应提出并建议新任务,不得静默扩大范围。