К основному содержанию
команда CX Codex

tdd · sangrokjung — команда для Claude Code: что делает и как установить

Команда ведёт задачу по циклу TDD: сначала интерфейсы и падающие тесты, затем код, рефакторинг и проверка покрытия.

MIT ★ 880 обновлён 2026-09-03

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/commands/tdd.md
Открыть на GitHub

Что делает tdd

Команда вызывает субагент tdd-guide и проводит задачу через несколько этапов: определить интерфейсы, написать тесты до реализации, запустить их и убедиться в корректной причине падения, затем добавить минимальный код. После зелёных тестов субагент рефакторит решение и снова запускает проверки.

Команда подходит для новых функций, компонентов, исправления ошибок и рефакторинга. Для бага она использует последовательность «воспроизвести тестом → подтвердить падение → исправить → подтвердить успех». В конце проверяется покрытие и добавляются тесты, если оно ниже 80%. Доступные инструменты команды: Agent, Read, Glob и Grep.

В Claude Code файл команды должен находиться по пути .claude/commands/tdd.md, иначе вызов /tdd не появится.

Какие задачи решает

  • сначала описать интерфейсы новой функции
  • написать падающий тест до реализации
  • доказать исправление бага переходом от падения к успеху
  • проверить покрытие тестами после рефакторинга

Примеры запросов агенту

  • Напиши функцию расчёта оценки ликвидности и проведи задачу по циклу /tdd.
  • Исправь ошибку в обработке пустого ответа: сначала создай воспроизводящий тест через /tdd.
  • Добавь новый компонент, проверь граничные случаи и добейся покрытия не ниже 80% с помощью /tdd.

Как установить tdd

Вручную: положить файлы

.claude/commands/tdd.md

Вызов — /tdd. Для всех проектов — ~/.claude/commands/

Вопросы о tdd

Как установить tdd в Claude Code?

Разместите файл команды по пути .claude/commands/tdd.md.

Что делает команда tdd?

Она запускает субагент tdd-guide, который ведёт задачу от интерфейсов и падающих тестов к минимальной реализации, рефакторингу и проверке покрытия.

Как команда tdd работает при исправлении ошибки?

Сначала создаётся тест, воспроизводящий ошибку, затем проверяется его падение. После исправления тест запускается снова и должен пройти.

Исходный текст

tdd.md · MIT
---
description: 테스트 먼저 만들고 코드 작성. 한 단위 작업에 사용.
allowed-tools: Agent, Read, Glob, Grep
---

# TDD Command

This command invokes the **tdd-guide** agent to enforce test-driven development methodology.

## What This Command Does

1. **Scaffold Interfaces** - Define types/interfaces first
2. **Generate Tests First** - Write failing tests (RED)
3. **Implement Minimal Code** - Write just enough to pass (GREEN)
4. **Refactor** - Improve code while keeping tests green (REFACTOR)
5. **Verify Coverage** - Ensure 80%+ test coverage

## When to Use

Use `/tdd` when:
- Implementing new features
- Adding new functions/components
- **Fixing bugs** → Prove-It Pattern: 버그 재현 테스트 먼저, 수정은 그 다음
- Refactoring existing code
- Building critical business logic

### Prove-It Pattern (버그 수정 전용)

```
BUG REPORT → REPRODUCE TEST (RED) → VERIFY FAIL → FIX (GREEN) → VERIFY PASS
```

버그 수정 시 "고쳤다"의 증거는 **실패→성공 전환**이다. 테스트 없이 수정하면 증상만 가린 것일 수 있다.

## How It Works

The tdd-guide agent will:

1. **Define interfaces** for inputs/outputs
2. **Write tests that will FAIL** (because code doesn't exist yet)
3. **Run tests** and verify they fail for the right reason
4. **Write minimal implementation** to make tests pass
5. **Run tests** and verify they pass
6. **Refactor** code while keeping tests green
7. **Check coverage** and add more tests if below 80%

## TDD Cycle

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

## Example Usage

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

## Step 2: Write Failing Test (RED)

```typescript
// 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()
    }

    const score = calculateLiquidityScore(market)

    expect(score).toBe(0)
  })
})
```

## Step 3: Run Tests - Verify FAIL

```bash
npm test lib/liquidity.test.ts

FAIL lib/liquidity.test.ts
  ✕ should return high score for liquid market (2 ms)
    Error: Not implemented

1 test failed, 0 passed
```

✅ Tests fail as expected. Ready to implement.

## Step 4: Implement Minimal Code (GREEN)

```typescript
// lib/liquidity.ts
export function calculateLiquidityScore(market: MarketData): number {
  // Handle zero volume edge case
  if (market.totalVolume === 0) {
    return 0
  }

  // Calculate component scores (0-100 scale)
  const volumeScore = Math.min(market.totalVolume / 1000, 100)
  const spreadScore = Math.max(100 - (market.bidAskSpread * 1000), 0)
  const traderScore = Math.min(market.activeTraders / 10, 100)

  // Recent activity bonus
  const hoursSinceLastTrade = (Date.now() - market.lastTradeTime.getTime()) / (1000 * 60 * 60)
  const recencyScore = Math.max(100 - (hoursSinceLastTrade * 10), 0)

  // Weighted average
  const score = (
    volumeScore * 0.4 +
    spreadScore * 0.3 +
    traderScore * 0.2 +
    recencyScore * 0.1
  )

  return Math.min(Math.max(score, 0), 100) // Clamp to 0-100
}
```

## Step 5: Run Tests - Verify PASS

```bash
npm test lib/liquidity.test.ts

PASS lib/liquidity.test.ts
  ✓ should return high score for liquid market (3 ms)
  ✓ should return low score for illiquid market (2 ms)
  ✓ should handle edge case: zero volume (1 ms)

3 tests passed
```

✅ All tests passing!

## Step 6: Refactor (IMPROVE)

```typescript
// lib/liquidity.ts - Refactored with constants and better readability
const WEIGHTS = {
  VOLUME: 0.4,
  SPREAD: 0.3,
  TRADERS: 0.2,
  RECENCY: 0.1,
} as const

const SCALE_FACTORS = {
  VOLUME: 1000,
  SPREAD: 1000,
  TRADERS: 10,
  RECENCY_PENALTY: 10,
} as const

function clamp(value: number, min: number, max: number): number {
  return Math.min(Math.max(value, min), max)
}

export function calculateLiquidityScore(market: MarketData): number {
  if (market.totalVolume === 0) return 0

  const volumeScore = Math.min(market.totalVolume / SCALE_FACTORS.VOLUME, 100)
  const spreadScore = clamp(100 - (market.bidAskSpread * SCALE_FACTORS.SPREAD), 0, 100)
  const traderScore = Math.min(market.activeTraders / SCALE_FACTORS.TRADERS, 100)

  const hoursSinceLastTrade = (Date.now() - market.lastTradeTime.getTime()) / (1000 * 60 * 60)
  const recencyScore = clamp(100 - (hoursSinceLastTrade * SCALE_FACTORS.RECENCY_PENALTY), 0, 100)

  const weightedScore =
    volumeScore * WEIGHTS.VOLUME +
    spreadScore * WEIGHTS.SPREAD +
    traderScore * WEIGHTS.TRADERS +
    recencyScore * WEIGHTS.RECENCY

  return clamp(weightedScore, 0, 100)
}
```

## Step 7: Verify Tests Still Pass

```bash
npm test lib/liquidity.test.ts

PASS lib/liquidity.test.ts
  ✓ should return high score for liquid market (3 ms)
  ✓ should return low score for illiquid market (2 ms)
  ✓ should handle edge case: zero volume (1 ms)

3 tests passed
```

✅ Refactoring complete, tests still passing!

## Step 8: Check Coverage

```bash
npm test -- --coverage lib/liquidity.test.ts

File           | % Stmts | % Branch | % Funcs | % Lines
---------------|---------|----------|---------|--------
liquidity.ts   |   100   |   100    |   100   |   100

Coverage: 100% ✅ (Target: 80%)
```

✅ TDD session complete!
```

## TDD Best Practices

**DO:**
- ✅ Write the test FIRST, before any implementation
- ✅ Run tests and verify they FAIL before implementing
- ✅ Write minimal code to make tests pass
- ✅ Refactor only after tests are green
- ✅ Add edge cases and error scenarios
- ✅ Aim for 80%+ coverage (100% for critical code)

**DON'T:**
- ❌ Write implementation before tests
- ❌ Skip running tests after each change
- ❌ Write too much code at once
- ❌ Ignore failing tests
- ❌ Test implementation details (test behavior)
- ❌ Mock everything (prefer integration tests)

## Test Types to Include

**Unit Tests** (Function-level):
- Happy path scenarios
- Edge cases (empty, null, max values)
- Error conditions
- Boundary values

**Integration Tests** (Component-level):
- API endpoints
- Database operations
- External service calls
- React components with hooks

**E2E Tests** (use `/e2e` command):
- Critical user flows
- Multi-step processes
- Full stack integration

## Coverage Requirements

- **80% minimum** for all code
- **100% required** for:
  - Financial calculations
  - Authentication logic
  - Security-critical code
  - Core business logic

## Important Notes

**MANDATORY**: Tests must be written BEFORE implementation. The TDD cycle is:

1. **RED** - Write failing test
2. **GREEN** - Implement to pass
3. **REFACTOR** - Improve code

Never skip the RED phase. Never write code before tests.

## Integration with Other Commands

- Use `/plan` first to understand what to build
- Use `/tdd` to implement with tests
- Use `/build-and-fix` if build errors occur
- Use `/code-review` to review implementation
- Use `/test-coverage` to verify coverage

## Related Agents

This command invokes the `tdd-guide` agent located at:
`~/.claude/agents/tdd-guide.md`

And can reference the `tdd-workflow` skill at:
`~/.claude/skills/tdd-workflow/`

---

## 다음 단계

구현이 완료되면:
- `/code-review`로 품질 검사

© sangrokjung · MIT · sangrokjung/claude-forge

Похожие слэш-команды

Все слэш-команды по теме «Тесты и QA» →

Сначала — tdd от других авторов.

tdd Affaan Mustafa Запускает субагента tdd-guide для разработки через тестирование: сначала интерфейсы и падающие тесты, затем код и проверка покрытия от 80%. CX Codex +1 ★ 6 739звёзд репо w-tdd blockmatic-icebox Скилл w-tdd для Claude Code ведёт разработку через цикл red-green-refactor. Он включается, когда разработчик просит применить TDD или этого требует репозиторий. CX Codex +1 647установок tdd-workflow davila7 Скилл tdd-workflow задаёт правила разработки через тестирование: цикл «красный — зелёный — рефакторинг» и запрет писать код до падающего теста. CX Codex +1 194установок 054-design-tdd Juan Antonio Breña Moral Скилл 054-design-tdd ведёт разработчика через цикл «красный-зелёный-рефакторинг» при тестировании Java-кода. Пишешь падающий тест, минимум кода для прохода, потом переделываешь — всё время держа тесты зелёными. CX Codex +1 177установок tdd-orchestrator davila7 Скилл tdd-orchestrator для Claude Code координирует разработку через тестирование по циклу red-green-refactor. Организует работу тестовых агентов и проверяет написание тестов до кода реализации. CX Codex +1 51установок tdd-refactor Seth Hobson Команда tdd-refactor проводит рефакторинг по TDD, сохраняя тесты зелёными. Она нужна для поэтапного улучшения структуры без изменения поведения. CX Codex +1 ★ 42 780звёзд репо TDD Refactor Phase - Improve Quality & Security официальный github Субагент TDD Refactor Phase - Improve Quality & Security для GitHub Copilot улучшает код после прохождения тестов и сверяет результат с задачей GitHub. Перед правками он просит подтвердить план. CX Codex +1 ★ 41 430звёзд репо

Из того же набора44

Весь набор →
rca-debugger Субагент rca-debugger разбирает сложные сбои, когда обычная отладка не нашла причину: например, при нестабильной ошибке или расхождении CI и локального запуска. CX Codex ★ 880звёзд репо security-reviewer Субагент security-reviewer проверяет изменения кода на уязвимости OWASP Top 10, зашитые секреты и дырявые зависимости. Возвращает отчёт с приоритетами и безопасными примерами. CX Codex ★ 880звёзд репо systematic-debugging Скилл systematic-debugging задаёт порядок поиска причины ошибки до предложения исправления. Подключайте его при сбоях сборки, деплоя, тестов и конфигурации, особенно после неудачных попыток починки. CX Codex +1 ★ 880звёзд репо harness-diet Скилл harness-diet для Claude Code, который измеряет always-loaded контекст харнесса и возвращает его в бюджет. Запускается, когда CLAUDE.md и всегда загружаемые правила разрослись. CX Codex +1 ★ 880звёзд репо escalation-fixer Субагент escalation-fixer для Claude берётся за сборку, если точечные фиксы не помогли, и может менять структуру проекта. CX Codex ★ 880звёзд репо e2e Команда e2e генерирует и запускает сквозные сценарии на Playwright с паттерном Page Object Model, собирая отчёты и снимки экрана. CX Codex +1 ★ 880звёзд репо skill-factory Скилл skill-factory для Claude Code анализирует действия в сессии и превращает повторяющиеся последовательности в новые скиллы. Сохраняет рабочие процессы для следующих задач. CX Codex +1 ★ 880звёзд репо skeptical-auditor Субагент skeptical-auditor для Claude Code заново запускает шаги тестирования и сверяет коды возврата с чужим отчётом об успехе. Перепроверяет отчёт агента о пройденных тестах. CX Codex ★ 880звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой