tdd · yeachan-heo — скилл для Claude Code: что делает и как установить
Задаёт строгий цикл TDD: агент пишет один падающий тест по согласованному шву, даёт минимальный зелёный код и откладывает рефакторинг на ревью.
MIT 244 установок ★ 40 997 обновлён 2026-10-24
npx skills add Yeachan-Heo/oh-my-claudecode --skill tdd -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/tdd/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/tdd/
1Через Skills CLI (Vercel)
npx skills add Yeachan-Heo/oh-my-claudecode --skill tdd -a codex2Вручную: положить файлы
.agents/skills/tdd/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Yeachan-Heo/oh-my-claudecode --skill tdd -a cursor2Вручную: положить файлы
.cursor/skills/tdd/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Yeachan-Heo/oh-my-claudecode skills/tdd2Вручную: положить файлы
.github/skills/tdd/SKILL.md1Через Skills CLI (Vercel)
npx skills add Yeachan-Heo/oh-my-claudecode --skill tdd -a gemini-cli2Командой платформы
gemini skills install https://github.com/Yeachan-Heo/oh-my-claudecode --path skills/tddВручную: положить файлы
.devin/skills/tdd/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Yeachan-Heo/oh-my-claudecode --skill tdd -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.