SuperAPI AI 工具集

test-driven-development

编程与开发

查看项目

更新于 10-16 03:40

技能介绍

这是一个测试驱动开发(TDD)技能,核心用途是在实现任何功能或修复 Bug 之前,先写测试并亲眼看到它失败,再写最小实现代码让其通过,最后重构。核心理念:没有看到测试失败,就无法确认测试测的是正确的东西;违反规则字面即违反规则精神。

适用场景:新功能、Bug 修复、重构、行为变更均需使用。例外情况为一次性原型、生成代码、配置文件,但仍建议先向人类伙伴确认。

铁律:没有失败的测试就不写生产代码。若先写了代码,必须删除并从测试重新实现,不得留作参考、边写测试边改编或不看它。

红-绿-重构循环:RED 写一个最小测试描述应有行为,测试须单一行为、名称清晰、优先测试真实代码;随后必须运行 npm test path/to/test.test.ts 亲眼验证失败,确认失败原因是功能缺失而非笔误。GREEN 编写通过该测试的最简代码,不额外加功能。再次运行测试验证通过且其他测试仍绿、输出干净。REFACTOR 仅在绿后清理重复、改进命名、抽取辅助,保持测试通过且不新增行为,然后重复。

好测试特征:最小(名称含 and 就拆分)、名称描述行为、体现意图并演示期望 API。文档列举了多种常见自我合理化借口及其反驳,例如“太简单不用测”“稍后补测”“已手动测过”等,均视为需停止并重写的红旗信号。

Bug 修复示例:对空邮箱被接受的问题,先写 rejects empty email 测试并运行确认失败,再写最小校验代码,验证通过后重构。

渐进具体化协议:执行时把规格视为渐进约束而非僵化蓝图。先读意图即设计契约(WHAT)而非实现细节(HOW);使用任何库前用 npm view <package> version 和 npm view <package> time.modified 核实存在与维护状态;设计指定的库或方法视为建议,可提出更优替代并附理由;实现选择在提交代码时才锁定。若发现 API 不存在、架构逻辑不通或存在更优方案,应停止并请求修订设计,不得静默编造变通方法。反幻觉清单要求在写实现前核实所有导入存在、方法签名与文档一致、数据流可行、无虚构 API。

完成前检查:每个新函数有测试、每个测试在实现前被看到失败、失败原因符合预期、写了最小通过代码、全部测试通过、输出干净、尽量用真实代码而非 mock、覆盖边界与错误。无法全部勾选即视为跳过 TDD,应重来。

卡住时:不知如何测试就写期望 API 和断言并询问伙伴;测试太复杂说明设计复杂需简化接口;必须 mock 一切说明耦合过高建议依赖注入;测试搭建过大应抽取辅助或简化设计。集成调试时,发现 Bug 先写复现的失败测试再修复,绝不在没有测试情况下修 Bug。添加 mock 或测试工具时需参考 @testing-anti-patterns.md 避免测试 mock 行为、给生产类加仅测试方法、未理解依赖就 mock 等反模式。

最终规则:生产代码必须有先失败的测试,否则不算 TDD;未经人类伙伴许可无例外。