Agent Skills
返回列表
💻

TDD 红绿重构工作流

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/tdd-workflows-tdd-cycle。

技能介绍

要解决什么问题

团队在「先写测试」上常常流于口号:实现已经写完才补测试、测试一开始就绿、跳过重构,覆盖率数字好看但缺陷照样逃逸。本技能把 红-绿-重构 拆成可执行阶段,并在关键节点设置 门控(例如:所有测试必须因缺少实现而失败,才能进入实现;全部通过后才能重构),用 Task 子智能体分工完成需求分析、测试架构、实现与审查。

工作方式与关键步骤

整体分为六段:测试规范与设计 → 红色(失败测试) → 绿色(最小实现) → 重构 → 集成/系统测试 → 持续改进。每个步骤都给出 subagent_type 与提示模板,输出物包括测试规范、失败验证报告、覆盖率指标与审查结论。

可配置质量门槛示例:行覆盖率 ≥80%、分支 ≥75%、关键路径 100%;重构触发条件包括圈复杂度 >10、方法 >20 行、类 >200 行、重复块 >3 行。支持两种节奏:

  • --incremental:单测逐个红-绿-重构
  • --suite:先写整模块失败套件,再一次性实现与重构

纪律被打破时有 失败恢复 流程:停止、定位违规阶段、回滚到上一有效状态再续跑,并跟踪各阶段耗时、周期数与覆盖率进展。

适用边界与注意点

适用于需要 测试优先 交付的功能或模块开发;与 TDD 无关的探索、或依赖本技能未覆盖的工具链时不必启用。细节示例见 resources/implementation-playbook.md。测试难写往往说明设计可测性不足;重构不是可选项,且单元测试宜保持快速(文档建议 <5 秒)。

使用场景

  • 新模块上线前,先让架构审查产出测试规范与边界矩阵,再编写必须失败的单元测试并通过失败验证门控。
  • 功能已实现但纪律混乱时,回滚到上一有效阶段,按红-绿-重构顺序重新跑完整 Task 编排流程。
  • 组件联调前,先写会因缺少集成逻辑而失败的集成测试,再实现数据流与 API 契约相关代码。
  • 单个验收点尚未覆盖时,使用 `--incremental` 只推进一条失败测试的最小实现与必要重构。

适合人员

  • 负责后端功能交付、必须在智能体会话里先写失败测试再写实现的开发工程师
  • 合并前需确认测试因缺实现而失败、而非断言写错的代码审查或 QA 负责人
  • 要先定测试结构、夹具与 mock 策略,再批量编写失败套件的模式下工作的测试自动化工程师
  • 需要按 80/75/100 覆盖率门槛与复杂度阈值收束重构、并留存阶段审查报告的技术负责人