tdd

TDD 命令

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

此命令的功能

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

何时使用

在以下情况使用 /aimax:tdd：

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

工作原理

tdd-guide 代理将：

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

TDD 循环

红色 → 绿色 → 重构 → 重复

红色：     编写一个失败的测试
绿色：     编写最小代码使其通过
重构：     改进代码，保持测试通过
重复：     下一个功能/场景

使用示例

用户：/aimax:tdd 我需要一个计算市场流动性评分的函数

代理（tdd-guide）：
# TDD 会话：市场流动性评分计算器

## 步骤 1：定义接口（搭建）

```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)
  })

  it('should handle edge case: zero volume', () => {
    const market = {
      totalVolume: 0,
      bidAskSpread: 0,
      activeTraders: 0,
      lastTradeTime: new Date()
    }