用途:在实现任何功能、修复 bug、重构或变更行为之前,先编写测试。核心原则是:没有看到测试失败,就不知道测试是否测了正确的东西。
主要能力:提供红-绿-重构循环的完整流程。红灯阶段写一个最小测试展示期望行为,名称清晰、只测一件事、尽量使用真实代码;随后必须运行测试并确认它因功能缺失而失败,而非报错或拼写错误。绿灯阶段写最少代码让测试通过,不添加额外功能或改进。重构阶段在保持绿灯的前提下消除重复、改善命名、提取辅助函数。
使用方式:先写失败测试,运行 npm test path/to/test.test.ts 验证失败原因符合预期;再写最少实现代码,再次运行确认通过且其他测试仍通过;最后重构并保持绿灯。完成前需运行项目完整测试套件(如 pytest、npm test、cargo test),即使任务只点名一个测试文件。
适用场景:新功能、Bug 修复、重构、行为变更。例外情况包括一次性原型、生成的代码、配置文件,但需先询问人类伙伴。
限制与规则:铁律是没有失败的测试就不写生产代码;先写代码再补测试必须删除重来,不保留参考、不改编、不看它。测试立即通过说明测的是已有行为,需修改测试。测试报错需修复错误直到正确失败。其他测试失败需立即修复。常见借口如“太简单不用测”“之后补测试”“已手动测试过”均被明确否定。遇到测试难写、setup 庞大等问题时,应简化设计或使用依赖注入。资料未提供具体安装命令或平台信息。