TDD编程工作流

技能文档

---
name: cuipengfei-programming-workflow
title: TDD编程工作流
category: 开发工具
description: 统一的测试驱动开发(TDD)编程工作流，包含准备、设计、测试实现、代码实现和审查五个阶段。当用户{进行编程任务、执行TDD开发、编写测试驱动代码}时触发。触发词：TDD工作流、测试驱动、编程流程、红绿重构。
---

# 统一编程工作流

本文档概述了结构化的编程工作流。遵循这一流程对于产出高质量、可维护的代码至关重要。

**主动遵循此工作流是高效编程能力的重要体现。**

## 阶段 0：准备与理解

1. **上下文化**: 彻底阅读项目文档以理解项目目标、架构和当前进度
2. **理解需求**: 澄清所有技术需求和目标。如果复杂，分解为更小的 MECE（相互独立、完全穷尽）子任务

## 阶段 1：设计（概念）

_约束：此阶段不要编写任何实现或测试代码。_

1. **系统/模块设计**: 定义所有相关的类、方法及其关系。使用图表或结构化列表澄清架构。确保每个组件都有单一职责。
2. **测试用例设计**: 为每个功能概念性地设计测试用例，指定输入、预期输出和场景类型（正面、负面、边界）。

## 阶段 2：测试实现 (TDD)

1. **编写失败测试**: 将阶段 1 的概念测试用例实现为可执行代码。这些测试最初应该失败。
   - **原则**: 遵循 TDD（红-绿-重构）。确保测试清晰、独立且可维护。

## 阶段 3：代码实现

1. **编写生产代码**: 编写使失败测试通过的最小代码。严格遵循阶段 1 的设计。
2. **重构**: 测试通过后，重构生产代码和测试代码以提高清晰度、效率并消除异味，确保所有测试仍然通过。

## 阶段 4：审查与完成

1. **自我审查**: 验证实现的代码和测试满足所有需求和质量标准
2. **文档**: 如适用，更新项目文档和任何其他相关文档

---

## 执行指导（TDD 教练模式）

当进行编程任务时，按以下流程执行：

### TDD 循环（红-绿-重构）

```
红（失败测试）→ 绿（最小实现）→ 重构（优化代码）→ 循环
```

1. **红**: 先写失败测试，定义期望行为
2. **绿**: 写最小代码使测试通过（不多不少）
3. **重构**: 优化代码结构，保持测试绿色

### 执行检查清单

| 阶段 | 检查项 |
|------|--------|
| 开始前 | ☐ 理解需求 ☐ 分解为 MECE 子任务 |
| 设计中 | ☐ 定义类/方法 ☐ 设计测试用例 |
| 测试中 | ☐ 测试先失败 ☐ 测试独立可维护 |
| 实现中 | ☐ 最小代码 ☐ 遵循设计 |
| 重构中 | ☐ 无代码异味 ☐ 测试仍通过 |

### 触发条件

- 新功能开发
- Bug 修复
- 代码重构
- 任何涉及代码变更的任务

### 关键原则

- **测试先行**: 永远先写测试，再写实现
- **小步前进**: 每次只改一小点，频繁运行测试
- **持续重构**: 保持代码清洁，技术债为零

使用说明

# TDD 编程工作流

统一的测试驱动开发（TDD）编程工作流，包含五个阶段：准备、设计、测试实现、代码实现和审查。

## 适用场景

- 新功能开发时遵循 TDD 流程
- Bug 修复时编写回归测试
- 代码重构时保证测试覆盖
- 任何涉及代码变更的任务

## 使用示例

开始一个新的编程任务时：

> 用 TDD 工作流帮我实现这个功能

助手会按照以下流程引导：

1. **阶段 0 - 准备**：阅读项目文档，理解需求并分解为 MECE 子任务
2. **阶段 1 - 设计**：概念性地定义类、方法和测试用例（不写代码）
3. **阶段 2 - 测试**：先编写会失败的测试（红灯）
4. **阶段 3 - 实现**：编写最小代码使测试通过（绿灯），然后重构
5. **阶段 4 - 审查**：自我审查并更新项目文档

## TDD 核心循环

```
红（失败测试）→ 绿（最小实现）→ 重构（优化代码）→ 循环
```

## 关键原则

- 测试先行：永远先写测试再写实现
- 小步前进：每次只改一小点，频繁运行测试
- 持续重构：保持代码清洁，技术债为零

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。