TDD教练Skill:用红-绿-重构循环,让 AI 带你把测试写在代码之前
- 一句话定位:它不是帮你“补测试”的工具,而是一位会打断你的坏习惯、逼你走完「红→绿→重构」的测试驱动开发教练。
- 核心方法论:坚持垂直切片(写一个测试→写一段实现→再循环),明确反对“先写完全部测试再写全部实现”的水平切片反模式。
- 最实用的约束:测试只走公开接口、只描述行为;重构只允许在绿色阶段进行,红色阶段绝不重构。
- 最适合谁:想把 TDD 真正落地的后端/前端开发者、需要写集成测试的团队、以及带新人建立测试习惯的技术负责人。
- 安装门槛:技能本身是纯方法论指导型能力,不依赖特定云服务;安装入口以你所用 AI 编程助手的官方说明为准。
该技能叫什么?如何一键安装 AI 技能提升开发效率?
技能档案
| 项目 | 内容 |
|---|---|
| 中文名 | TDD教练Skill |
| 英文名 | tdd-coach |
| 技能ID | 14292 |
| 能力类型 | 开发方法论指导 / 测试驱动开发流程教练 |
它解决什么问题
TDD 的道理人人都懂,但落地时几乎都会撞上三个坑:
- 节奏错了:一口气写完十个测试,再一口气写完十段实现,也就是技能中明确批评的「水平切片」。这样写出的测试测的是“想象中的行为”和“数据结构的形状”,行为坏了测试却通过,行为没变测试却挂掉。
- 测试写歪了:mock 内部协作者、测私有方法、绕过接口直接查数据库。这些测试和实现死绑,重构一次就全红,团队于是开始“跳过测试”。
- 重构没有窗口:测试还没全绿就开始改结构,结果红色状态越滚越大,最后只能放弃。
这个技能把「规划 → 示踪弹 → 增量循环 → 重构」四段流程和两份检查清单固化进对话,让 AI 在每一步提醒你回到正确节奏。
一键安装的思路与步骤
技能详情中没有给出具体的安装命令或技能市场链接,因此下面只描述通用思路,具体入口请以官方说明为准:
- 确认前提:你使用的 AI 编程助手 / 智能体平台需要支持技能(Skill)机制,即能够加载一份以
SKILL.md形式描述的能力包,并允许在会话中被触发。 - 找到技能:在平台的技能库、技能市场或插件中心中,用技能ID 14292 或英文名 tdd-coach 检索。
- 启用安装:按平台提供的方式一键添加/启用;若你的环境是本地技能目录形式,则按官方说明将技能包放入对应目录,并确保描述中的触发条件可被读取。
- 验证是否生效:新开一个会话,输入一句“请用 TDD 的方式帮我实现 XXX 功能”。如果技能生效,回应的第一反应不应是直接甩代码,而是反问你:公开接口应该是什么样?哪些行为最重要、需要先测? 随后才进入第一轮“红→绿”。若它直接开始写实现,说明技能未被触发,可尝试重新启用,或在提问中明确说“用红绿重构循环来做”。
该技能的主要功能和特点
-
强制节奏:垂直切片与「示踪弹」 先写一个测试、再写最小实现让它在端到端跑通,这条贯通路径就是示踪弹;之后每个行为都重复一次“一个测试 → 一段实现”,而不是批量铺开。
-
区分好测试与坏测试 好测试通过公开 API 执行真实代码路径,读起来像一份规格说明(例如“用户可以用有效购物车结账”);坏测试与实现耦合。技能给出一个非常直观的判据:你重构了代码、行为没变,测试却挂了,那就是坏测试。
-
反模式预警:水平切片 明确禁止“红阶段=写完所有测试,绿阶段=写完所有代码”,并解释其后果:测试跑在前灯之前、绑定函数签名、对真实变化不敏感。
-
前置规划清单 写代码之前先与用户确认接口变更、要测的行为及其优先级、是否存在做「深模块」(小接口、深实现)的机会、如何为可测试性设计接口,并列出“行为清单”而非“实现步骤”。
-
每轮循环的收口检查 测试是否描述行为而非实现?是否只使用公开接口?是否能在内部重构中存活?实现是否是当前测试的最小实现?有没有偷偷加上推测性功能?
-
重构专项指引 所有测试通过后才进入重构:提取重复代码、加深模块、在自然处应用 SOLID、反思新代码暴露了旧代码的什么问题,并且每次重构后立即跑测试。
-
配套参考文档 技能内引用了测试示例、mock 使用指南、深模块、接口设计与重构候选等配套文档,可按需深挖某一环节。
和普通 AI 编程助手比强在哪:普通助手更倾向于“一次给你完整方案”,速度很快但节奏是错的;这个技能的价值恰恰在于限制你一次只做一步,并把“测试该写什么”从模糊拍脑袋变成有检查清单的对话。
如何使用该技能?
触发方式(满足任一即可)
- 直接说“我想用 TDD 的方式开发这个功能”;
- 提到“红绿重构”“测试先行”;
- 提出“需要做集成测试”;
- 说“先写测试再写实现”或“帮我在写代码前定好测试”。
分步骤使用指南
- 说清目标与边界。给出业务需求、涉及的模块、你希望的对外能力。示例输入:「我要给订单服务加一个“优惠券叠加”能力,最多叠加两张,请用 TDD 方式来做,先不要写实现。」
- 进入规划对话。按技能要求,它会先问:公开接口应该是什么样?哪些行为最重要、需要先测?此时你只需回答这两点,其余交给它整理成行为清单(注意是行为,不是实现步骤)。
- 确认计划。检查清单里是否包含:接口变更点、行为优先级、可测试性设计、是否识别出深模块机会。确认后进入下一步。
- 打第一颗示踪弹。它写第一个行为测试(此时应当是失败的红色),然后只写让这个测试通过的最小实现。示例输出:一个描述“两张优惠券叠加后金额正确”的集成测试 + 恰好能通过的实现,不包含任何“顺手加上”的边界逻辑。
- 增量循环。对剩余每个行为重复“写一个测试 → 写最小实现”。如果它一次给了你多个测试,直接提醒:“回到垂直切片,一次只写一个测试。”
- 进入重构。全部测试通过后再一起看:有没有重复代码、能不能加深模块、哪里适合应用 SOLID。红色阶段不允许重构,如果它在测试还是红的时候提议改结构,要拦住。
- 用检查清单收尾。逐条核对:测试是否只依赖公开接口、能否在内部重构中存活、实现是否最小、有没有推测性功能。这份清单可以直接贴进 PR 描述里。
使用小贴士
- 描述行为时用“用户/调用方可以……”的句式,天然贴近技能要求的规格化测试命名。
- 涉及外部依赖时,主动说明哪些是可 mock 的边界、哪些必须走真实路径,能减少返工。
- 一次会话只聚焦一个功能点,把“行为清单”控制在可讨论的规模内。
同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势与不足 |
|---|---|---|---|---|---|
| tdd-coach(TDD教练Skill) | 方法论教练型技能,管节奏也管测试质量 | 红-绿-重构流程引导、垂直切片、行为清单规划、反模式预警、循环检查清单、重构专项指引 | 需在支持技能机制的 AI 助手中启用,入口以官方说明为准;使用上需要接受“一次只做一步”的慢节奏 | 新功能测试先行开发、Bug 修复的回归测试、遗留代码重构前的行为固化、团队 TDD 规范落地 | 优势:纠正的是“做法”而不只是“产出”,能长期改善测试质量;不足:不直接生成大批量测试用例,追求“快”的人会觉得被拖慢 |
| 通用 AI 编程助手(对话式) | 通用编码助手 | 直接生成实现代码、按需补测试、解释代码 | 门槛最低,多数 IDE 或网页端即可使用 | 快速出原型、写一次性脚本、补覆盖率 | 优势:速度快、覆盖面广;不足:默认走“先实现后补测”,容易产出与实现耦合的测试,缺乏节奏约束 |
| 单元测试生成类插件/工具 | 测试产出工具 | 基于已有实现反向生成测试、统计覆盖率 | 一般需在 IDE 或 CI 中集成 | 给存量代码补测试、提升覆盖率数字 | 优势:批量、省事;不足:天然是“实现先行”,生成的多为结构性/耦合型测试,重构即红,无法替代 TDD 的行为设计 |
| 人工 TDD 教练 / 结对编程 | 人际辅导 | 实时点评、现场纠偏、团队工作坊 | 成本最高,需要排期与预算 | 团队转型、新人培养、关键模块攻坚 | 优势:反馈最精准、能推动组织习惯改变;不足:不可随取随用,单次成本高,难以覆盖日常每一次循环 |
如何选:想要“更多测试”选测试生成工具;想要“更对的测试和可重构的代码”选 tdd-coach;想要组织级习惯改造,用人工教练配合本技能做日常陪练是性价比较高的组合。
该技能的典型应用场景与实际体验情况
场景一:后端开发者从零实现一个新接口 角色:负责订单服务的后端工程师。痛点:需求一复杂就想先写实现,测试变成事后补的形式主义。使用方式:把需求丢进去,用 TDD 方式开发,先确认公开接口和行为优先级,再打示踪弹。实际体验:上手不难,但前十分钟会有明显“被按住”的感觉——它反复把话题拉回“先确认接口和行为”。坚持两三轮后,行为清单会变成一份很清晰的规格说明,后期的边界补充反而更快。注意:一定要在规划阶段把优先级说清楚,否则行为清单会过长。
场景二:修复线上 Bug 时的测试先行 角色:值班工程师。痛点:修完就上线,没有留下能防复发的测试。使用方式:描述 Bug 现象与预期行为,先用一个失败的测试复现问题(红),再写最小修复让它变绿。实际体验:这一步最大收益是“先复现再修”,避免了猜着改代码。注意事项:复现测试要写成面向行为的断言,而不是断言某个内部函数被调用了几次。
场景三:遗留代码重构前的行为固化 角色:接手老系统的开发者。痛点:不敢动,一动就炸。使用方式:先用集成风格测试把关键路径的行为固定下来,再进入重构阶段提取重复代码、加深模块。实际体验:技能反复强调的“重构必须从绿色阶段开始”“每步重构后跑测试”让过程可控;更关键的是它会提醒你判断——如果重构后测试挂了但行为没变,说明测试本身要改,而不是代码有问题。
场景四:Tech Lead 统一团队 TDD 规范 角色:技术负责人。痛点:每个人对 TDD 的理解都不一样,Code Review 里吵不清。使用方式:把技能里的“每轮循环检查清单”直接作为 PR 评审清单使用。实际体验:检查清单足够短、足够可执行,比长篇规范文档更容易被接受;新人通过和技能对话几轮后,对“好测试/坏测试”的判断标准会明显收敛。
该技能能为用户带来的价值
- 把方法论变成可执行的动作:TDD 难的不是概念,而是每一步的自我克制。技能用“一次一个测试”“只写最小实现”“红色阶段不重构”这些硬约束,把抽象原则变成了可以照着走的路标。
- 提升测试的“保质期”:行为导向、只走公开接口的测试能在重构中存活,长期看显著降低因结构变动导致的测试维护成本——这是覆盖率数字无法衡量的收益。
- 降低 TDD 的上手门槛:不需要先读完一本书,只要会描述需求和接口,就能在对话中被带着走完一整轮循环,边做边理解为什么这样做。
- 减少返工与缺陷外溢:先复现再修复、先固化行为再重构,能有效避免“改一处炸三处”的连锁问题。
- 沉淀团队资产:每轮生成的测试本身就是一份可读的规格说明,新人接手时读测试就能理解系统“做什么”,而不是去猜“怎么做”。
常见问题 FAQ
Q1:这个技能怎么安装?需要付费吗? A:在支持技能机制的平台里,用技能ID 14292 或英文名 tdd-coach 检索并启用即可;若为本地技能目录形式,按官方说明放置技能包。是否需要付费、是否有额度限制,取决于你所用平台的计费策略,以官方说明为准。
Q2:它会不会直接帮我把所有测试和代码都写好? A:不会,这正是它的设计意图。它坚持垂直切片——写一个测试,写一段最小实现,再循环;并且会在规划阶段先和你确认公开接口和要测的行为。如果你想要“一次生成一整套测试”,那属于测试生成类工具的场景。
Q3:适合谁用?前端/后端/非开发岗都能用吗? A:最适合需要长期维护代码的开发者和技术负责人,尤其是要做集成测试、要重构遗留系统、想统一团队测试规范的场景。只要你的技术栈支持自动化测试,方法论本身与语言无关。
Q4:和直接用通用 AI 助手写测试有什么区别? A:通用助手倾向“先实现再补测”,产出的测试容易与实现耦合;TDD教练Skill 管的是节奏和测试质量:先规划行为清单、一次一个测试、只写最小实现、绿了才重构,并用检查清单判断测试能否在重构中存活。
Q5:用起来会不会很慢?怎么提高效率? A:前期确实会比“直接写实现”慢,但慢在需求澄清和接口设计上,这部分成本本来就要付。提效的方式是:一次会话只做一个功能点、在规划阶段就把行为优先级说清楚、描述行为时用“调用方可以……”的句式,减少来回澄清。