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

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

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

MIT 244 установок ★ 40 997 обновлён 2026-10-24

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

Что делает tdd

Скилл регламентирует разработку через тестирование малыми шагами. Сначала агент фиксирует утверждённый шов (seam) и пишет по нему тест. Тест запускается и обязан упасть именно с предсказанной ошибкой. После этого агент пишет минимальный объём кода, который делает тест зелёным. Каждый шаг работает как трассирующая пуля: проверяется сквозной пользовательский путь, а не изолированный технический слой.

Ожидаемые значения берутся исключительно из независимых источников: строк спецификации, примеров или описанной документации. Тесту запрещено сверяться с поведением самой реализации. Заглушки разрешены только на внешней границе шва. Использовать моки внутри тестируемого контура скилл прямо запрещает.

Рефакторинг полностью исключён из цикла red-green: править структуру кода разрешено только на этапе ревью. Если поведение программы не укладывается ни в один утверждённый шов, агент останавливает работу и сообщает о проблеме для анализа через architecture-survey и refit.

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

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

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

  • Напиши падающий тест по согласованному шву API для сценария оплаты.
  • Воспроизведи ошибку расчёта скидки через тест перед внесением правок.
  • Покажи отчёт red/green с трассирующим тестом для механизма сессий.

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

1Через Skills CLI (Vercel)

npx skills add Yeachan-Heo/oh-my-claudecode --skill tdd -a claude-code

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

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

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

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

Вопросы о tdd

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

Выполните команду npx skills add Yeachan-Heo/oh-my-claudecode --skill tdd -a claude-code. Конфигурация запишется в ~/.claude/skills/tdd/SKILL.md.

Что делает скилл tdd?

Он ведёт агента по циклу разработки: один тест по утверждённому шву, проверка его падения и минимальная правка кода до зелёного статуса.

Можно ли рефакторить код прямо во время прохождения TDD-цикла?

Нет. Правила скилла запрещают рефакторить код в фазе red-green: эта задача переносится на стадию ревью.

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

SKILL.md · MIT
---
name: tdd
description: Test-first at pre-agreed seams — one test, one implementation, tracer-bullet red/green; independent expected values; substitutions only at the seam's boundary class; launch Phase 4 reference.
---

# TDD

Red-green in small steps, at seams that were agreed in advance. In a launch run the seam list is C2's approved output; outside launch, agree the seams with the user before the first test exists — a seam nobody approved gets no tests.

## The loop

One test → one implementation → repeat:

1. Write the next test at a seam. Run it. Watch it fail for the reason you expect — a test that cannot fail is not a test.
2. Implement the smallest change that turns it green.
3. Repeat. Each test is a tracer bullet: a narrow but complete path through the behavior, not a layer finished in isolation.

## Rules

- Expected values come from an independent source of truth — a spec line, a worked example, a documented output. Never from the implementation under test: a test that asserts what the code happens to do is a mirror, not a check.
- Substitute at the seam's declared boundary class only — in-process, locally substitutable, owned-remote port, or true-external, the class C2 records for each seam. No substitutes inside the boundary the test is exercising.
- Refactoring is not part of the loop. It belongs to the review stage; the repair worker owns it. Do not refactor mid-red-green.
- A bug fix starts with the failing test that reproduces it — reproduction before theory, the debugger's rule.
- When proposing a seam, say in one line what it catches and what it lets through — a seam choice nobody can price is a guess, not a decision.

## When no seam fits

If the behavior cannot be tested at any approved seam, stop and say so: report the missing seam as a finding (it feeds `architecture-survey` and `refit`) rather than inventing a seam or testing through internals.

## Output

- The seam list used, with boundary classes and each seam's catch/miss line
- Red/green evidence — the failing run and the passing run
- Any seam-absence findings

© Yeachan-Heo · MIT · Yeachan-Heo/oh-my-claudecode

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

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

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

tdd Matt Pocock Скилл управляет циклом красный-зелёный в TDD: проверяет, что тесты пишутся до кода, держит их на уровне публичных интерфейсов и не завязывает на внутреннюю структуру. CX Codex +1 1 141 062установок tdd backnotprop Скилл tdd для Claude Code заставляет агента воспроизводить баг падающим тестом перед правкой кода. Включается по прямому запросу на TDD или при наличии дешёвого локального теста. CX Codex +1 10 000установок tdd codewithmukesh Скилл tdd ведёт строгий цикл разработки через тестирование в .NET 10: от падающего теста в xUnit v3 до минимального кода и рефакторинга. CX Codex +1 4 000установок tdd parcadei Скилл tdd ведёт агента по строгому циклу red-green-refactor: сначала падающий тест, потом минимальный код, потом проверка. CX Codex +1 474установок tdd glebis Скилл tdd организует разработку через тесты с разделением ролей между отдельными субагентами. Помогает писать код по циклу RED-GREEN-REFACTOR. CX Codex +1 262установок tdd-green Seth Hobson Команда tdd-green реализует минимальный код для прохождения упавших тестов на зелёной фазе TDD. Защищает от преждевременной оптимизации и лишних функций. CX Codex +1 ★ 42 780звёзд репо test-driven-development addyosmani Скилл test-driven-development для Claude Code ведёт разработку через цикл «красный — зелёный — рефакторинг». Он подключается при добавлении логики, исправлении ошибки и изменении поведения кода. CX Codex +1 78 300установок 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-london-chicago proffesor-for-testing Скилл tdd-london-chicago помогает вести TDD по лондонской или чикагской школе: выбирать моки либо реальные объекты и проходить цикл Red–Green–Refactor. CX Codex +1 124установок

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

Весь набор →
execute Скилл execute для Claude Code ведёт задачу от согласованного плана до кода и проверки. Реализует изменение и подтверждает его работоспособность. CX Codex +1 307установок graph Скилл graph запускает многошаговые пайплайны как ориентированные графы и после сбоя продолжает работу по журналу с незавершённых узлов. CX Codex +1 285установок drydock Скилл drydock для Claude Code разворачивает общую среду разработки в репозитории. При первом запуске создаёт CLAUDE.md и GLOSSARY.md, остальные поверхности — при первом использовании. CX Codex +1 273установок launch Скилл launch для организации полного цикла доставки: от постановки задачи к выпуску проверенного кода. Разделяет работу между агентом (всё, что можно автоматизировать и проверить) и человеком (решения без однозначного ответа). CX Codex +1 272установок harbor Скилл harbor разбирает входящие issue и PR, проверяет каждое утверждение и отдаёт мейнтейнеру только те решения, которые правда требуют его подписи. CX Codex +1 241установок minimal-prose-discipline Скилл minimal-prose-discipline для Claude Code сокращает ответы агента, сохраняя команды и ошибки без изменений и убирая служебную болтовню. Делает рабочие сообщения яснее. CX Codex +1 204установок architecture-survey Скилл architecture-survey для Claude Code анализирует граф модулей репозитория и выявляет поверхностную изоляцию и лишние швы. Находит места, из-за которых правки затрагивают слишком много файлов. CX Codex +1 201установок agent-doc-discipline Скилл agent-doc-discipline задаёт правила оформления инструкций, спецификаций и файлов навыков для ИИ-агентов. Пригодится при составлении CLAUDE.md, чтобы агент понимал задачу с первого раза без истории чата. CX Codex +1 196установок

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

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