用途:在实现任何功能或修 bug 前强制采用测试驱动开发(TDD)。适用包括新功能、缺陷修复、重构与行为变更;一次性原型、生成代码和配置文件可经人类伙伴同意后例外。
主要能力:明确红-绿-重构循环。红灯阶段写一个最小测试,描述期望行为,命名清晰、只测一件事、尽量用真实代码而非 mock。必须运行 npm test path/to/test.test.ts 亲眼看它失败,确认失败原因是功能缺失而非拼写错误。绿灯阶段只写能让测试通过的最简代码,不额外加功能或重构;再次运行确认通过且其他测试不受影响、输出无错误警告。重构阶段仅在绿灯后进行去重、改命名、抽辅助函数,并保持测试通过。随后为下一功能写下一个失败测试。
限制与原则:铁律是没有失败测试就不写生产代码;若先写了代码,必须删除并重新开始,不能保留作参考或边写测试边改编。该技能认为测试后写、跳过 TDD、说“这次例外”等理由都是合理化借口,因为后写的测试会立即通过,无法证明它测对了东西;手工测试无记录、不可重复。若不知道如何测试,可先写期望的 API 或断言,或询问人类伙伴。资料另提供测试反模式文档 @testing-anti-patterns.md 供添加 mock 或测试工具时参考。资料未提供具体安装方式、收费与平台支持信息。