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

tdd-workflow · travisjneuman — скилл для Claude Code: цикл RED-GREEN-REFACTOR

Скилл tdd-workflow для Claude Code, Codex, Cursor и других платформ, который включает режим разработки через тесты: сначала пишется падающий тест (RED), потом минимальный код для прохода (GREEN), затем рефакторинг.

MIT 141 установок ★ 114 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add travisjneuman/.claude --skill tdd-workflow -a claude-code
Открыть на GitHub

Что делает tdd-workflow

Применяет цикл TDD: в RED-фазе скилл требует написать падающий тест до реализации, в GREEN — минимум кода для прохода, в REFACTOR — чистку без изменения поведения. Каждый шаг завершается запуском тестов. Внутри — чек-листы для каждой фазы, примеры паттерна AAA (Arrange-Act-Assert), правила именования тестов и таблицы граничных случаев.

Указаны целевые метрики покрытия: statements 85 %, branches 80 %, functions 90 %. В списке распространённых ошибок TDD — тестирование реализации вместо поведения, большие тесты и общее состояние между кейсами. Скилл не включается по умолчанию: срабатывает только при явном запросе test-first или работы над покрытием.

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

  • внедрить цикл RED-GREEN-REFACTOR в команде
  • написать тест до реализации функции
  • поднять покрытие тестами до 85 %
  • отловить граничные случаи (пустые входы, NULL, MAX_INT)
  • избежать хрупких тестов, привязанных к реализации

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

  • Включи TDD-режим и добавь метод multiply в калькулятор
  • Напиши тесты для UserService.getPermissions по циклу RED-GREEN-REFACTOR
  • Покажи, как протестировать граничные случаи для parseDate

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

1Через Skills CLI (Vercel)

npx skills add travisjneuman/.claude --skill tdd-workflow -a claude-code

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

~/.claude/skills/tdd-workflow/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tdd-workflow/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tdd-workflow

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

Выполни npx skills add travisjneuman/.claude --skill tdd-workflow -a claude-code, скилл окажется в ~/.claude/skills/tdd-workflow/SKILL.md. Для Cursor команда та же, но с флагом -a cursor, путь .cursor/skills/tdd-workflow/SKILL.md.

Что делает tdd-workflow?

Включает режим разработки через тесты: сначала падающий тест (RED), потом минимальный код для прохода (GREEN), затем рефакторинг без изменения поведения (REFACTOR). Работает только при явном запросе test-first или улучшения покрытия.

На каких платформах работает tdd-workflow?

Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Установка через npx skills add с флагом платформы или gh skill install для Copilot.

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

SKILL.md · MIT
---
name: tdd-workflow
description: Test-Driven Development workflow enforcement with RED-GREEN-REFACTOR cycle. Use only when the user explicitly asks for test-first work or improved test coverage.
---

# Test-Driven Development (TDD) Workflow

Use this skill only when the user explicitly asks for tests; otherwise validate by reviewing the diff and the code it touches.

A disciplined approach to development where tests drive design and implementation.

## The TDD Mantra

> "Never write a line of code without a failing test."

## The RED-GREEN-REFACTOR Cycle

### RED Phase: Write a Failing Test

**Goal**: Define the expected behavior BEFORE implementation.

**Rules**:

1. Write the smallest test that fails
2. Test must fail for the RIGHT reason
3. Test should clearly express intent
4. Don't write implementation yet

**Example**:

```typescript
// RED: Test the behavior we want
describe("Calculator", () => {
  it("should add two numbers", () => {
    const calc = new Calculator();
    expect(calc.add(2, 3)).toBe(5);
  });
});

// Run: npm test
// Result: FAIL - Calculator is not defined
// This is RED ✓
```

**Checklist**:

- [ ] Test is written
- [ ] Test fails when run
- [ ] Failure message is clear
- [ ] Test name describes expected behavior

---

### GREEN Phase: Make the Test Pass

**Goal**: Write the MINIMUM code to pass the test.

**Rules**:

1. Do the simplest thing that works
2. Don't add extra features
3. Don't optimize
4. Just make it green

**Example**:

```typescript
// GREEN: Minimum implementation to pass
class Calculator {
  add(a: number, b: number): number {
    return a + b; // Simplest thing that works
  }
}

// Run: npm test
// Result: PASS
// This is GREEN ✓
```

**Checklist**:

- [ ] Test passes
- [ ] No extra code added
- [ ] Implementation is minimal

---

### REFACTOR Phase: Improve the Code

**Goal**: Clean up while keeping tests green.

**Rules**:

1. Only refactor with passing tests
2. Run tests after each change
3. Improve design, not behavior
4. Small, incremental changes

**Examples of refactoring**:

- Extract methods
- Rename for clarity
- Remove duplication
- Improve performance
- Add types/documentation

**Checklist**:

- [ ] Tests still pass
- [ ] Code is cleaner
- [ ] No behavior changed
- [ ] Ready for next RED

---

## TDD in Practice

### Starting a New Feature

```
1. Write high-level acceptance test (may not run yet)
2. Write first unit test (RED)
3. Implement minimum code (GREEN)
4. Refactor if needed (REFACTOR)
5. Repeat 2-4 until feature complete
6. Verify acceptance test passes
```

### Test Structure (AAA Pattern)

```typescript
it("should [behavior] when [condition]", () => {
  // Arrange - Set up test data and dependencies
  const user = createTestUser({ role: "admin" });
  const service = new UserService();

  // Act - Execute the code under test
  const result = service.getPermissions(user);

  // Assert - Verify expected outcomes
  expect(result).toContain("delete");
  expect(result).toContain("edit");
});
```

### Test Naming Convention

```
[Unit]_[Scenario]_[ExpectedResult]
```

Examples:

- `add_withPositiveNumbers_returnsSum`
- `login_withInvalidPassword_throwsAuthError`
- `getUser_whenNotFound_returnsNull`

---

## Test Categories

### Unit Tests

- Single function/class in isolation
- Mock all dependencies
- Fast (<10ms per test)
- Run constantly during development

### Integration Tests

- Multiple components together
- Real database (test instance)
- Slower but more realistic
- Run before commits

### End-to-End Tests

- Full system through UI
- Slowest, most realistic
- Run in CI/CD pipeline
- Cover critical user paths

---

## TDD Best Practices

### DO:

- Start with the simplest case
- Write one test at a time
- Keep tests independent
- Test behavior, not implementation
- Use descriptive test names
- Commit after each green

### DON'T:

- Write code before tests
- Test private methods directly
- Test framework code
- Overfit tests to implementation
- Skip the refactor phase

---

## Edge Cases to Test

Always test:

- Empty inputs (null, undefined, [], {}, '')
- Boundary values (0, -1, MAX_INT, min/max dates)
- Error conditions (network fail, invalid input)
- Permission boundaries
- Concurrent access
- Unicode/special characters

---

## Test Coverage Guidelines

| Metric     | Minimum | Target |
| ---------- | ------- | ------ |
| Statements | 70%     | 85%    |
| Branches   | 70%     | 80%    |
| Functions  | 80%     | 90%    |
| Lines      | 70%     | 85%    |

Coverage is a metric, not a goal. 100% coverage doesn't mean bug-free.

---

## Quick Reference

```
RED    → Write failing test (define behavior)
GREEN  → Minimum code to pass (make it work)
REFACTOR → Clean up (make it right)
COMMIT → Save progress (make it permanent)
```

---

## Common TDD Mistakes

| Mistake                | Problem       | Solution               |
| ---------------------- | ------------- | ---------------------- |
| Testing implementation | Brittle tests | Test behavior/outcomes |
| Tests too large        | Hard to debug | Smaller, focused tests |
| Shared state           | Flaky tests   | Isolate each test      |
| Slow tests             | Skipped tests | Mock external deps     |
| Testing obvious code   | Wasted time   | Focus on logic         |

© travisjneuman · MIT · travisjneuman/.claude

Похожие скиллы

Все скиллы по теме «Тесты и QA» →

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

tdd-workflow ruvnet Скилл tdd-workflow ведёт агента по циклу London School: падающий тест с замоканными зависимостями, минимальная реализация, рефакторинг. Шаги фиксируются в MCP-хуках. CX Codex +1 743установок tdd-workflow Affaan Mustafa Скилл tdd-workflow заставляет агента писать тесты до кода и держать покрытие не ниже 80%: юнит, интеграционные и E2E на Playwright. CX Codex +1 ★ 6 739звёзд репо tdd-workflow davila7 Скилл tdd-workflow задаёт правила разработки через тестирование: цикл «красный — зелёный — рефакторинг» и запрет писать код до падающего теста. CX Codex +1 194установок tdd Rohit Ghumare Скилл tdd задаёт для Claude Code цикл разработки через тесты: сначала падающий тест, затем минимальный рабочий код и рефакторинг. CX Codex +1 ★ 2 966звёзд репо tdd-london-chicago proffesor-for-testing Скилл tdd-london-chicago помогает вести TDD по лондонской или чикагской школе: выбирать моки либо реальные объекты и проходить цикл Red–Green–Refactor. CX Codex +1 124установок rtk-tdd rtk-ai Скилл rtk-tdd ведёт разработку на Rust по циклу Red-Green-Refactor и сам включается для задач с кодом, тестами, рефакторингом и исправлением ошибок. CX Codex +1 2 300установок backend-development-tdd-orchestrator Seth Hobson Субагент backend-development-tdd-orchestrator для Claude Code ведёт разработку по red-green-refactor: сначала тест, потом код, потом рефакторинг. Держит дисциплину тестов в проекте и следит, чтобы тест появлялся раньше кода. CX Codex ★ 42 780звёзд репо tdd-guide alirezarezvani Скилл tdd-guide для Claude Code создаёт тесты по требованиям и коду, анализирует покрытие и ведёт по циклу Red-Green-Refactor. Находит непротестированные сценарии. CX Codex +1 ★ 907звёзд репо w-tdd blockmatic-icebox Скилл w-tdd для Claude Code ведёт разработку через цикл red-green-refactor. Он включается, когда разработчик просит применить TDD или этого требует репозиторий. CX Codex +1 647установок

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

Весь набор →
event-driven-architecture Скилл event-driven-architecture для Claude Code помогает проектировать системы с асинхронными сообщениями, брокерами и распределёнными сценариями. Разбирает архитектуру микросервисов и потоков событий. CX Codex +1 143установок content-repurposer Скилл content-repurposer переделывает статью, отчёт или вебинар в тред, пост для LinkedIn, карусель и рассылку и подгоняет тон под площадку. CX Codex +1 142установок generic-feature-developer Скилл generic-feature-developer ведёт новую фичу по шагам: разобраться в коде, выбрать паттерн, собрать мелкими коммитами и проверить края перед закрытием. CX Codex +1 142установок generic-fullstack-design-system Скилл generic-fullstack-design-system для Claude Code помогает настраивать дизайн-систему во фулстек-проектах на Next.js и NestJS: тему, Tailwind, компоненты shadcn/ui и тёмную тему. CX Codex +1 142установок core-workflow Скилл core-workflow собирает рабочие протоколы для агента: правила Git, чек-листы безопасности и доступности, разбор задач по сложности. Загружается сам для сложных задач или по запросу конкретного паттерна. CX Codex +1 141установок newsletter-creator Скилл newsletter-creator собирает выпуск корпоративной рассылки по готовому каркасу: порядок разделов, отбор ссылок по баллам и правила вёрстки письма. CX Codex +1 140установок generic-react-feature-developer Скилл generic-react-feature-developer для Claude Code задаёт архитектуру React-компонентов: каталоги, Zustand и React Query, IndexedDB и ленивую загрузку. CX Codex +1 139установок svelte-development Скилл svelte-development для Claude Code помогает писать приложения на Svelte 5 и SvelteKit. Включается при работе с реактивностью, маршрутизацией, серверными функциями и миграцией со Svelte 4. CX Codex +1 139установок

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

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