用途:该技能用于在实现任何新功能、修复缺陷、重构或改变行为时,强制采用测试驱动开发流程。核心原则是:如果没有亲眼看到测试失败,就不知道它是否测试了正确的东西。
主要能力:定义红-绿-重构循环。RED 阶段写一个最小测试,展示期望行为,要求单一行为、名称清晰、尽量使用真实代码而非 mock;随后必须运行测试并确认它因功能缺失而失败。GREEN 阶段写最简单代码让测试通过,不添加额外功能或重构。REFACTOR 阶段在测试保持绿色的前提下清理重复、改进命名、提取辅助函数,不新增行为。
使用方式:先写失败测试,运行 npm test path/to/test.test.ts 验证失败原因正确;再写最小实现,再次运行确认通过且其他测试仍通过、输出无错误警告;最后重构并保持绿色。循环重复,为下一个功能写下一个失败测试。
适用场景:新功能、缺陷修复、重构、行为变更。例外情况包括一次性原型、生成代码和配置文件,但需询问人类伙伴。
限制与要求:铁律是“没有失败测试就不写生产代码”。若先写了代码,必须删除并从头开始,不得保留为参考、不得在写测试时改编、不得查看。测试应在实现前强制发现边界情况。资料还列出常见合理化借口、红旗信号、验证清单、卡住时的处理建议以及测试反模式,并建议在添加 mock 或测试工具时阅读 @testing-anti-patterns.md。最终规则:生产代码必须有先失败过的测试,否则不算 TDD。