用途:该技能指导 AI 智能体按测试驱动开发(TDD)流程编写代码,核心是“先写测试、看它失败、再写最小代码通过、最后重构”。适用于实现新功能或函数、修复缺陷(先写复现缺陷的失败测试)、重构(用测试保护行为),以及用户明确要求 TDD、test first 或 red-green-refactor 时。
主要能力:提供红-绿-重构循环的完整步骤与判定标准。RED 阶段写一个描述目标行为的失败测试,测试名即规格,采用 Arrange-Act-Assert,优先测试真实行为,仅在网络、数据库等必要处使用 mock;随后运行测试确认因正确原因失败。GREEN 阶段只写让测试通过的最小代码,不加额外功能,运行单个测试与完整测试套件确认无回归。REFACTOR 阶段在测试全绿前提下消除重复、改进命名、抽取辅助函数,不新增行为,然后进入下一个测试。
使用方式:使用项目现有测试框架(Jest、pytest、xUnit 等)与既有模式;运行测试的命令按项目而定,资料示例为 npm test path/to/test.test.ts。修复缺陷时先写能捕获该缺陷的失败测试,再最小化修复。集成或端到端测试同样先定义预期行为的失败测试再实现。
限制与红线:未看到测试失败就不能确认测试正确;不得以“快速修复”“太简单”“稍后补测试”为由跳过;测试若首次运行即通过,说明未经历 RED,需调整;不得保留参考代码再补测试,应从测试出发实现;除非用户明确批准(如一次性原型、生成的配置),否则生产代码只能在失败测试之后编写。完成前需核对:每个新行为都有先写的测试、亲眼看到其失败且原因正确、代码最小、全部测试通过且无新警告错误、相关边界与错误已被覆盖。