tdd-cycle

name	tdd-cycle
description	执行 TDD 红绿重构循环（RED→GREEN→REFACTOR→REPEAT），通过先写失败测试、最小代码实现、保持绿色重构的节奏驱动开发。当启动功能开发、需要测试驱动节奏、进行迭代编码、追求高测试覆盖率时使用。提供检查清单和节奏控制。
stage	EXECSPEC_FULFILL
level_supported	["L1-STREAMLINED"]

TDD Cycle Skill

Scope: EXECSPEC_FULFILL — Fulfill ExecSpec（落实 ExecSpec）

版本: 0.1.0（占位）| 创建日期: 2025-11-27

---

概述

TDD Cycle 是测试驱动开发的核心循环：

┌─────────────────────────────────────────────────────┐
│              🔄 TDD Cycle                           │
├─────────────────────────────────────────────────────┤
│       ┌─────┐                                      │
│       │ RED │ ← 写失败的测试                        │
│       └──┬──┘                                      │
│          ↓                                         │
│       ┌─────┐                                      │
│       │GREEN│ ← 最小代码让测试通过                  │
│       └──┬──┘                                      │
│          ↓                                         │
│    ┌──────────┐                                    │
│    │REFACTOR │ ← 重构，保持测试绿色                 │
│    └────┬─────┘                                    │
│         └──────→ REPEAT                            │
└─────────────────────────────────────────────────────┘

核心节奏：

• 🔴 RED: 先写失败的测试
• 🟢 GREEN: 写最小代码让测试通过
• 🔵 REFACTOR: 重构代码，保持测试绿色
• 🔁 REPEAT: 循环直到功能完成

---

L1-STREAMLINED

检查清单

• 测试先于实现代码编写
• 每次 GREEN 后立即考虑重构
• 单元测试覆盖率 ≥ 80%
• 测试金字塔比例合理（60%单元/30%集成/10%E2E）
• GOAL 注释已添加到测试文件

通过标准

• 5 项中 4 项通过（≥80%）

---

>> 命令

>>tdd_check_l1         # 检查 TDD 节奏
>>coverage_report_l1   # 测试覆盖率报告

---

GOAL 注释规范

// GOAL: GOAL-XXX-001
describe('功能描述', () => {
  it('should ...', () => {
    // 测试代码
  });
});

---

常见问题

🔴 RED 阶段

问题：测试写得太大 解决：每个测试只验证一个行为

问题：不知道先测什么 解决：从最简单的 Happy Path 开始

🟢 GREEN 阶段

问题：写了太多代码 解决：只写让测试通过的最小代码

问题：想一步到位 解决：接受"丑陋"的代码，重构阶段再优化

🔵 REFACTOR 阶段

问题：跳过重构 解决：每次 GREEN 后强制问自己"能更简单吗？"

问题：重构时破坏测试 解决：小步重构，每步都运行测试

---

相关 Skills

• 前置: bdd-scenario（BDD 场景已定义）
• 并行: code-quality（质量门禁）
• 原则: principle-dry, principle-kiss

---

TODO: 待细化覆盖率检查脚本和 TDD 节奏监控