测试驱动开发（TDD）的核心在于 Red-Green-Refactor 循环：先写失败的测试，再写刚好通过的代码，最后重构保持测试通过。当 Agent 介入开发流程后，这一人工驱动的纪律需要转化为可自动执行的技能框架。本文提出面向 TDD 的 Agent 技能框架，实现从需求解析到代码重构的自动化闭环。
三层技能模型
Agent 的 TDD 技能框架由三层构成：需求解析层、测试执行层、代码生成层。每层承担明确的职责边界，通过状态机驱动循环流转。
需求解析层负责将自然语言需求转化为可测试的契约。关键技能包括边界识别（提取输入域、异常场景）、断言生成（构建具体可验证的期望输出）、以及测试命名规范化。该层输出的是结构化测试意图，而非直接生成测试代码。
测试执行层管理 Red 阶段的验证逻辑。Agent 必须确认测试以预期方式失败 —— 不是编译错误，也不是无关异常，而是断言失败且失败信息指向未实现的功能。这层技能包含失败模式识别、失败原因校验、以及测试隔离性检查。
代码生成层处理 Green 与 Refactor 阶段。Green 阶段执行最小实现策略，Refactor 阶段则在保持测试通过的前提下进行代码优化。两层之间通过测试状态作为门禁：只有全部测试通过时才允许进入重构。
Red 阶段的自动化验证
TDD 的首要纪律是 "没有失败的测试就不能写生产代码"。Agent 技能框架通过以下机制强制执行：
失败验证清单：在生成任何实现代码前，Agent 必须完成四项检查 —— 测试是否编译通过、是否以断言方式失败、失败信息是否匹配预期、测试是否聚焦于单一行为。任一检查未通过，循环退回需求解析阶段。
预期失败日志：Agent 记录每次 Red 阶段的失败输出，作为后续 Green 阶段的验收标准。这防止了测试误报 —— 即测试因错误原因通过的情况。
最小测试粒度控制：技能框架限制每个测试只验证一个行为维度。当 Agent 检测到测试包含多个断言或复杂条件分支时，触发拆分建议。
Green 阶段的最小实现策略
Green 阶段的核心是 "刚好通过测试的最小代码"。Agent 技能框架通过以下参数控制实现范围：
实现深度限制：设定代码复杂度阈值，如圈复杂度不超过 3、函数行数不超过 15 行。超出阈值时触发重构预警。
硬编码优先原则：对于首个测试，允许使用硬编码返回值的实现方式。Agent 技能框架将此视为合法策略，而非需要立即消除的债务。随着测试用例增加，硬编码自然会被一般化逻辑取代。
YAGNI 守卫：Agent 在 Green 阶段禁止添加测试中未验证的功能。技能框架通过静态分析检测未覆盖代码路径，标记为待处理债务。
Refactor 阶段的安全保障
重构阶段的风险在于意外改变行为。Agent 技能框架建立多重安全网：
测试频率门控：规定重构操作的最大粒度 —— 每修改 5 行代码或每 3 分钟必须运行一次测试套件。Agent 自动触发测试执行，中断任何导致失败的修改。
行为等价性检查：引入代码变更前后的行为对比机制。对于纯函数，对比输入输出映射；对于状态 ful 代码，追踪状态转换序列。
回滚触发器：当测试失败时，Agent 技能框架自动回滚至上一次通过的代码状态，并记录失败原因。这避免了在失败状态下继续修改导致的调试困难。
可落地的验证清单
将上述框架转化为 Agent 可执行的验证清单：
| 阶段 | 检查项 | 失败处理 |
|---|---|---|
| Red | 测试编译通过 | 修复语法错误后重试 |
| Red | 断言失败且原因正确 | 修正测试逻辑 |
| Red | 无生产代码存在 | 删除预写代码 |
| Green | 测试全部通过 | 修复实现逻辑 |
| Green | 圈复杂度 ≤ 3 | 标记为重构债务 |
| Green | 无未覆盖代码 | 添加测试或删除代码 |
| Refactor | 测试保持通过 | 自动回滚 |
| Refactor | 代码异味计数下降 | 记录重构效果 |
实践建议
渐进式启用：不要在现有项目中一次性启用完整框架。建议从新增功能模块开始，逐步扩展到修复和重构场景。
反馈延迟控制：TDD 的有效性依赖于快速反馈。Agent 技能框架应配置测试超时参数 —— 单元测试单例不超过 500ms，套件不超过 30 秒。超出时触发并行化或测试拆分。
Mock 使用边界：技能框架默认优先使用真实依赖。仅在涉及外部服务、文件系统或随机源时允许 Mock，且必须在测试注释中说明理由。
人机协作模式：Agent 负责执行纪律和重复验证，人类开发者保留架构决策权。关键节点（如大规模重构）设置人工确认门禁。
总结
面向 TDD 的 Agent 技能框架将 Red-Green-Refactor 循环转化为可自动执行的状态机。通过三层技能模型、严格的验证清单、以及可量化的参数控制，实现需求到重构的自动化闭环。这一框架不是取代开发者判断，而是将 TDD 纪律从依赖个人习惯转变为系统级保障。
参考来源
- Playbooks: Agent Skills Standard - TDD Skill (https://playbooks.com/skills/hoangnguyen0403/agent-skills-standard/tdd)
- Pluralsight: Implementing the Red-Green-Refactor Cycle in TDD
内容声明：本文无广告投放、无付费植入。
如有事实性问题，欢迎发送勘误至 i@hotdrydog.com。