tdd

TDD 命令

此命令调用 tdd-guide 智能体（Agent）来强制执行测试驱动开发（TDD）方法论。

此命令的作用

1. 搭建接口（Scaffold Interfaces） - 首先定义类型/接口
2. 先生成测试 - 编写失败的测试（红/RED）
3. 编写最小化实现代码 - 只编写刚好能通过测试的代码（绿/GREEN）
4. 重构（Refactor） - 在保持测试通过的前提下优化代码（重构/REFACTOR）
5. 验证覆盖率 - 确保测试覆盖率达到 80% 以上

适用场景

在以下情况下使用 /tdd：

• 实现新功能
• 添加新的函数/组件
• 修复 Bug（先编写重现该 Bug 的测试）
• 重构现有代码
• 构建核心业务逻辑

工作原理

tdd-guide 智能体将：

1. 为输入/输出定义接口
2. 编写会失败（FAIL）的测试（因为代码尚未存在）
3. 运行测试并验证它们因预期的原因而失败
4. 编写最小化实现以使测试通过
5. 运行测试并验证它们通过
6. 在保持测试通过的前提下重构代码
7. 检查覆盖率，如果低于 80% 则添加更多测试

TDD 循环

红 (RED) → 绿 (GREEN) → 重构 (REFACTOR) → 重复 (REPEAT)

红 (RED):      编写一个失败的测试
绿 (GREEN):    编写最小化代码以通过测试
重构 (REFACTOR): 改进代码，保持测试通过
重复 (REPEAT):   下一个功能/场景

使用示例

User: /tdd 我需要一个计算市场流动性评分（market liquidity score）的函数

Agent (tdd-guide):
# TDD 会话：市场流动性评分计算器

## 步骤 1：定义接口 (SCAFFOLD)

```typescript
// lib/liquidity.ts
export interface MarketData {
  totalVolume: number
  bidAskSpread: number
  activeTraders: number
  lastTradeTime: Date
}

export function calculateLiquidityScore(market: MarketData): number {
  // TODO: 待实现
  throw new Error('Not implemented')
}

步骤 2：编写失败的测试 (RED)

// lib/liquidity.test.ts
import { calculateLiquidityScore } from './liquidity'

describe('calculateLiquidityScore', () => {
  it('should return high score for liquid market', () => {
    const market = {
      totalVolume: 100000,
      bidAskSpread: 0.01,
      activeTraders: 500,
      lastTradeTime: new Date()
    }

    const score = calculateLiquidityScore(market)

    expect(score).toBeGreaterThan(80)
    expect(score).toBeLessThanOrEqual(100)
  })

  it('should return low score for illiquid market', () => {
    const market = {
      totalVolume: 100,
      bidAskSpread: 0.5,
      activeTraders: 2,
      lastTradeTime: new Date(Date.now() - 86400000) // 1 天前
    }

    const score = calculateLiquidityScore(market)

    expect(score).toBeLessThan(30)
    expect(score).toBeGreaterThanOrEqual(0)
  })