tdd

TDD 命令

此命令调用 tdd-guide 代理来强制执行测试驱动开发方法。

此命令的作用

1. 搭建接口 - 首先定义类型/接口
2. 首先生成测试 - 编写失败的测试（红）
3. 实现最小化代码 - 编写刚好足够的代码以通过测试（绿）
4. 重构 - 改进代码，同时保持测试通过（重构）
5. 验证覆盖率 - 确保 80%+ 的测试覆盖率

何时使用

在以下情况下使用 /tdd：

• 实现新功能时
• 添加新函数/组件时
• 修复错误时（首先编写重现错误的测试）
• 重构现有代码时
• 构建关键业务逻辑时

工作原理

tdd-guide 代理将：

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

TDD 循环

RED → GREEN → REFACTOR → REPEAT

RED:      Write a failing test
GREEN:    Write minimal code to pass
REFACTOR: Improve code, keep tests passing
REPEAT:   Next feature/scenario

使用示例

User: /tdd I need a function to calculate market liquidity score

Agent (tdd-guide):
# TDD Session: Market Liquidity Score Calculator

## Step 1: Define Interface (SCAFFOLD)

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

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

步骤 2：编写失败的测试（红）

// 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 day ago
    }

    const score = calculateLiquidityScore(market)

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