SuperAPI AI 工具集

tdd

编程与开发

查看项目

更新于 10-16 06:21

技能介绍

用途:在 Codex 中进行有纪律的测试先行(test-first)实现。每当用户希望先写测试再实现功能时使用该技能。

循环流程:每个功能依次经过 RED、DOMAIN、GREEN、DOMAIN、COMMIT 五个阶段。RED 阶段为下一个行为写一个失败测试,优先从验收边界入手,必要时向内细化,运行测试并捕获真实失败。DOMAIN 阶段审查测试与浮现的结构,检查是否存在基本类型偏执或非法状态风险,必要时引入类型桩或语义类型。GREEN 阶段用最小可用实现修复下一个真实失败,不得改写测试去迎合代码;若改动过大则下钻到更小的内层循环。随后再次进行 DOMAIN 审查实现完整性,最后 COMMIT:运行相关更广的检查,并在开始新 RED 前立即提交。每个完成的绿色切片或已接受的发现各自构成提交边界,除非用户明确要求其他批处理方式。此处的提交指主干路径上的本地 git 提交,而非开 PR。

阶段边界:RED 编辑测试;DOMAIN 编辑或提出类型与领域结构;GREEN 编辑实现;COMMIT 执行 git 与验证步骤,不做新功能。这些边界在 Codex 中部分为建议性,因为当前最强的钩子面在 Bash 而非每次文件编辑,但仍应遵守。

由外向内:尽量从应用边界开始;只调用内部辅助函数的测试不算该切片的验收测试;下钻到更小单元循环时保持外层行为可见。

委派:默认单智能体 TDD 循环;仅在明确要求或确有价值的受限旁路审查/实现切片时使用子智能体;不要把编排隐藏在通用管理智能体中。

证据:RED 后运行测试;GREEN 期间运行变更的测试路径;COMMIT 前运行更广的相关检查集;没有实际命令输出不得声称成功。

Codex 专属指引:保持循环兼容直接提交主干的工作方式;不要假设 PR 审查或基于分支的门禁;领域检查点使用 domain-modeling 技能;若需额外审查,在 TDD 循环后使用 codex-review。

完成条件:预期测试先于实现写出;测试以最小代码通过;实现前后均审查领域问题;循环在下一个 RED 前以真实提交结束。