claude-code-best/docs/design/nested-agent/prompts/tdd.md

TDD Skill (L1/L2)

概述

测试驱动开发(TDD)：RED → GREEN → REFACTOR 循环

深度状态

• 当前深度: L1 或 L2 (根据调用上下文)
• 最大深度: 2
• 可spawn: 无 (叶子节点)

TDD三阶段

┌─────────────────────────────────────────────────────────────┐
│                         TDD循环                              │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   ┌─────────┐     ┌─────────┐     ┌─────────────┐         │
│   │   RED   │ ──→ │  GREEN  │ ──→ │  REFACTOR   │         │
│   │ 写测试   │     │ 写实现   │     │   重构优化   │         │
│   │ 测试失败 │     │ 测试通过 │     │  覆盖率检查  │         │
│   └─────────┘     └─────────┘     └─────────────┘         │
│        │               │                  │                  │
│        └───────────────┴──────────────────┘                  │
│                        ↓                                     │
│              ┌─────────────────┐                            │
│              │   下一测试用例    │                            │
│              └─────────────────┘                            │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Phase 1: RED (失败测试)

任务

编写测试代码，测试必须失败（因为实现还不存在）

规则

✅ 必须

• 为每个功能点编写完整测试
• 使用describe/test/it结构
• 包含Arrange-Act-Assert模式
• 设置正确的expected值
• Mock外部依赖

❌ 禁止

• 不要写任何实现代码
• 不要尝试让测试通过
• 不要跳过任何测试用例

输出

{
  "phase": "RED",
  "test_files": [
    {
      "path": "src/__tests__/auth.login.test.ts",
      "content": "import { describe, test, expect } from 'vitest'..."
    }
  ],
  "expected_failures": ["TC001", "TC002", "TC003"],
  "run_command": "bun test src/__tests__/auth.login.test.ts"
}

Phase 2: GREEN (通过实现)

任务

编写最小实现代码，让所有测试通过

规则

✅ 必须

• 编写最小化实现
• 让所有RED阶段的测试通过
• 不写多余代码 (YAGNI原则)
• 保持代码简洁

❌ 禁止

• 不要跳过任何测试
• 不要写未来可能用到的代码
• 不要过度设计

输出

{
  "phase": "GREEN",
  "implementation_files": [
    {
      "path": "src/services/auth.service.ts",
      "changes": {"additions": 30, "deletions": 0}
    }
  ],
  "test_results": {
    "total": 3,
    "passed": 3,
    "failed": 0
  }
}

Phase 3: REFACTOR (重构优化)

任务

优化代码结构，保持测试通过

规则

✅ 必须

• 优化代码结构和命名
• 消除重复代码
• 提高可读性
• 保持所有测试通过

❌ 禁止

• 不要添加新功能
• 不要破坏现有测试
• 不要降低覆盖率

覆盖率要求

• 行覆盖率 >= 80%
• 分支覆盖率 >= 75%
• 函数覆盖率 >= 90%

输出

{
  "phase": "REFACTOR",
  "refactored_files": [
    {
      "path": "src/services/auth.service.ts",
      "improvements": ["提取validateToken函数", "简化错误处理"]
    }
  ],
  "coverage": {
    "lines": 85,
    "branches": 78,
    "functions": 92
  },
  "test_results": {
    "total": 3,
    "passed": 3,
    "failed": 0
  }
}

Mock使用

Vitest Mock模板

import { vi } from 'vitest'

// 模块Mock
vi.mock('../services/apiClient', () => ({
  fetch: vi.fn().mockResolvedValue({ data: 'mocked' })
}))

// 函数Mock
const mockFn = vi.fn()
  .mockReturnValue('result')
  .mockResolvedValue('async result')
  .mockRejectedValue(new Error('error'))

Mock验证

// 验证调用
expect(mockFn).toHaveBeenCalled()
expect(mockFn).toHaveBeenCalledWith('arg1', 'arg2')
expect(mockFn).toHaveBeenCalledTimes(1)

// 验证调用顺序
expect(mockFn.mock.calls).toEqual([
  ['call1'],
  ['call2']
])

完整输出格式

{
  "tdd_id": "tdd_xxx",
  "status": "completed",
  "phases": {
    "red": {
      "tests_written": 5,
      "test_files": ["test1.ts", "test2.ts"],
      "expected_failures": 5
    },
    "green": {
      "implementation_files": ["service.ts"],
      "tests_passed": 5,
      "tests_failed": 0
    },
    "refactor": {
      "files_refactored": 2,
      "improvements": ["提取公共函数", "简化逻辑"]
    }
  },
  "coverage": {
    "lines": 85,
    "branches": 78,
    "functions": 92
  },
  "verdict": "PASS",
  "total_duration_ms": 5000
}

错误处理

RED阶段测试通过

{
  "error": "TDD_VIOLATION",
  "message": "Test passed in RED phase - tests must fail before implementation",
  "violated_tests": ["TC001"],
  "suggestion": "Remove implementation or fix test expectation"
}

GREEN阶段测试失败

{
  "error": "IMPLEMENTATION_INCOMPLETE",
  "message": "Tests failed after implementation",
  "failed_tests": ["TC002"],
  "suggestion": "Complete implementation for failing test cases"
}

覆盖率不达标

{
  "error": "COVERAGE_BELOW_THRESHOLD",
  "current": {"lines": 65, "branches": 60},
  "required": {"lines": 80, "branches": 75},
  "suggestion": "Add more test cases for uncovered branches"
}