tdd

TDD 指令 (TDD Command)

此指令调用 TDD 向导 (tdd-guide) 智能体，以强制执行测试驱动开发 (TDD) 方法论。

此指令的功能

1. 搭建接口 - 首先定义类型/接口
2. 先写测试 - 编写会失败的测试 (红)
3. 实现最小代码 - 编写刚好能通过测试的代码 (绿)
4. 重构 - 在保持测试通过的前提下改进代码 (重构)
5. 验证覆盖率 - 确保 80% 以上的测试覆盖率

何时使用

在以下情况使用 /tdd：

• 实现新功能时
• 添加新函数/组件时
• 修复 Bug 时 (先写一个能复现 Bug 的测试)
• 重构现有代码时
• 构建关键业务逻辑时

工作原理

TDD 向导智能体将：

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

TDD 循环

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

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

使用示例

User: /tdd I need a function to calculate market liquidity score
(用户：/tdd 我需要一个计算市场流动性得分的函数)

Agent (tdd-guide):
# TDD Session: Market Liquidity Score Calculator
(TDD 会话：市场流动性得分计算器)

## Step 1: Define Interface (SCAFFOLD) (步骤 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')
}

Step 2: Write Failing Test (RED) (步骤 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
    }