TDD с интеграционными тестами

Ведёт разработку через тесты на публичных интерфейсах: согласует с пользователем швы для тестов, делает по одному циклу red-green на тест, мокает только границы системы, рефакторинг оставляет ревью. Для случаев, когда фичу или баг делают тестами вперёд.

ТестированиеПак: Скиллы Мэтта Покока38 строкtdd
Автор
Источник
mattpocock/skills/skills/engineering/tdd @ abeeaf9
Лицензия
MIT · Copyright (c) 2026 Matt Pocock

Об этом скилле

Что делает

Справочник по циклу red-green, нацеленный на тесты, которые стоит хранить. Прежде чем писать тест, агент называет швы — публичные границы, где поведение видно, не заглядывая внутрь, — к каждому пишет строку о том, что он ловит и что пропускает, и просит вас подтвердить список. Каждый цикл — один шов, один падающий тест и минимум кода, чтобы тест прошёл. Рефакторинг из цикла вынесен на этап ревью.

Названы три антипаттерна: тесты, привязанные к реализации (моки внутренних модулей, приватные методы, проверка через базу вместо интерфейса); тавтологичные тесты, где ожидаемое значение считается так же, как в коде; горизонтальная нарезка — сначала все тесты, потом весь код. Агент читает GLOSSARY.md, если он есть, чтобы называть тесты словами предметной области, и учитывает ADR.

В папке два файла-помощника. tests.md сравнивает хорошие и плохие тесты на TypeScript: оформление заказа через публичный API, проверка пользователя через getUser, а не SQL-запросом, итог сверяется с готовым числом, а не пересчитывается тем же способом, что в коде. mocking.md разрешает моки только на границах системы — внешние API, время, случайность — и показывает внедрение зависимостей и клиент в стиле SDK, где на каждый внешний вызов своя функция.

Когда включать и когда не надо

Для фичи или исправления бага тестами вперёд, когда нужны интеграционные тесты через настоящие интерфейсы, а не набор моков.

Не нужен для кода на выброс — авторский Прототип на выброс нарочно обходится без тестов — и для покрытия уже написанного кода: там лучше подойдёт Написание юнит-тестов.

Как поставить и вызвать

Команда установки ниже кладёт всю папку. Агент сам подхватывает скилл по описанию, когда работа идёт через тесты; вызвать вручную:

  • Claude Code: /tdd или попросить скилл по имени.
  • Codex: $tdd.
  • Cursor: наберите / в чате Agent и выберите tdd.

Пример: /tdd Добавь промокоды в оформление заказа. Сначала предложи швы для тестов.

Когда под вопросом форма интерфейса, скилл вызывает Проектирование глубоких модулей, а рефакторинг оставляет на Ревью по стандартам и спецификации — поставьте оба. Реализация спецификации по тикетам запускает этот скилл в каждом субагенте-исполнителе.

Чем отличается от похожих

Три других TDD-скилла каталога держат рефакторинг внутри цикла. Наша Разработка через тесты (TDD) добавляет базовый прогон и отчёт о каждом красном и зелёном шаге, TDD по методу Superpowers удаляет код, написанный раньше теста, а TDD: красный, зелёный, рефакторинг Адди Османи делает ставку на юнит-тесты. Только этот скилл сначала согласует с вами швы и тестирует только на них. Те три ставятся в папку test-driven-development, этот — в tdd, так что ни с одним из них он не конфликтует.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/tdd/SKILL.md https://anymodel.org/en/skills/matt-pocock/tdd/SKILL.md -o ~/.claude/skills/tdd/LICENSE https://anymodel.org/en/skills/matt-pocock/tdd/LICENSE -o ~/.claude/skills/tdd/agents/openai.yaml https://anymodel.org/en/skills/matt-pocock/tdd/agents/openai.yaml -o ~/.claude/skills/tdd/mocking.md https://anymodel.org/en/skills/matt-pocock/tdd/mocking.md -o ~/.claude/skills/tdd/tests.md https://anymodel.org/en/skills/matt-pocock/tdd/tests.md
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/tdd/SKILL.md https://anymodel.org/en/skills/matt-pocock/tdd/SKILL.md -o ~/.agents/skills/tdd/LICENSE https://anymodel.org/en/skills/matt-pocock/tdd/LICENSE -o ~/.agents/skills/tdd/agents/openai.yaml https://anymodel.org/en/skills/matt-pocock/tdd/agents/openai.yaml -o ~/.agents/skills/tdd/mocking.md https://anymodel.org/en/skills/matt-pocock/tdd/mocking.md -o ~/.agents/skills/tdd/tests.md https://anymodel.org/en/skills/matt-pocock/tdd/tests.md
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','agents/openai.yaml','mocking.md','tests.md') { $p = Join-Path "$HOME\.claude\skills\tdd" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/matt-pocock/tdd/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','agents/openai.yaml','mocking.md','tests.md') { $p = Join-Path "$HOME\.agents\skills\tdd" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/matt-pocock/tdd/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/matt-pocock/tdd/SKILL.md

SKILL.md

Исходник

Test-Driven Development

TDD is the red → green loop. This skill is the reference that makes that loop produce tests worth keeping: what a good test is, where tests go, the anti-patterns, and the rules of the loop. Every section applies on every cycle: consult them before and during the loop, not after.

When exploring the codebase, read GLOSSARY.md (if it exists) so test names and interface vocabulary match the project's domain language, and respect ADRs in the area you're touching.

What a good test is

Tests verify behavior through public interfaces, not implementation details. Code can change entirely; tests shouldn't. A good test reads like a specification: "user can checkout with valid cart" tells you exactly what capability exists, and it survives refactors because it doesn't care about internal structure.

See tests.md for examples and mocking.md for mocking guidelines.

Seams: where tests go

A seam is the public boundary you test at: the interface where you observe behavior without reaching inside. Tests live at seams, never against internals.

Test only at pre-agreed seams. Before writing any test, write down the seams under test and confirm them with the user. No test is written at an unconfirmed seam. You can't test everything, so agreeing the seams up front is how testing effort lands on the critical paths and complex logic instead of every edge case.

Ask: "What's the public interface, and which seams should we test?" Give each proposed seam a one-line note on what it catches and what it misses.

When the shape of that interface is itself in question (how deep the module is, where the seam belongs, what the interface should expose), call the Skill tool with "codebase-design" for the vocabulary. It is the shared source of the module, interface, depth, seam, adapter, leverage and locality terms, and it is a reference to consult, not a session to run.

Anti-patterns

  • Implementation-coupled: mocks internal collaborators, tests private methods, or verifies through a side channel (querying the database instead of using the interface). The tell: the test breaks when you refactor but behavior hasn't changed.
  • Tautological: the assertion recomputes the expected value the way the code does (expect(add(a, b)).toBe(a + b), a snapshot derived by hand the same way, a constant asserted equal to itself), so it passes by construction and can never disagree with the code. Expected values must come from an independent source of truth: a known-good literal, a worked example, the spec.
  • Horizontal slicing: writing all tests first, then all implementation. Bulk tests verify imagined behavior: you test the shape of things rather than user-facing behavior, the tests go insensitive to real changes, and you commit to test structure before understanding the implementation. Work in vertical slices instead: one test → one implementation → repeat, each test a tracer bullet that responds to what the last cycle taught you.

Rules of the loop

  • Red before green. Write the failing test first, then only enough code to pass it. Don't anticipate future tests or add speculative features.
  • One slice at a time. One seam, one test, one minimal implementation per cycle.
  • Refactoring is not part of the loop. It belongs to the review stage (see the code-review skill), not the red → green implementation cycle.

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Мэтта Покока

Ревью по стандартам и спецификации

Проверяет дифф от коммита, ветки или тега по двум осям в параллельных субагентах: записанные стандарты репозитория с базовым набором запахов кода по Фаулеру и исходная спецификация. Для случаев, когда ветку или PR надо сверить с задачей.

Проектирование глубоких модулей

Задаёт общий словарь для глубоких модулей — интерфейс, шов, адаптер, глубина — с тестом на удаление, видами зависимостей и проектированием в нескольких вариантах через субагентов. Для случаев, когда нужно придумать интерфейс модуля или место шва.

Диагностика сложных багов

Диагностирует сложные баги и просадки скорости: сначала собирает быструю детерминированную команду, воспроизводящую точный симптом, потом ужимает её, ранжирует проверяемые гипотезы и пишет регрессионный тест. Для случаев, когда что-то падает или тормозит.

Модель предметной области

Уточняет язык предметной области по ходу проектирования: оспаривает размытые и противоречивые термины, сразу пишет согласованные в GLOSSARY.md и предлагает короткий ADR лишь для трудно обратимых решений. Для случаев, когда обсуждают термины или пишут ADR.

Реализация спецификации по тикетам

Реализует спецификацию и её тикеты на одной интеграционной ветке: по свежему субагенту-исполнителю на тикет в своём worktree, параллельно по графу блокировок, затем ревью и один проход исправлений. Для случаев, когда тикеты из to-tickets уже готовы.

Улучшение архитектуры кодовой базы

Ищет мелкие модули, которые стоит углубить, начиная с чаще всего меняющегося кода, показывает кандидатов в HTML-отчёте со схемами «до и после» и разбирает выбранный вместе с вами. Для случаев, когда код стало трудно тестировать и понимать.

Прототип на выброс

Пишет прототип на выброс под один вопрос о дизайне: кликабельное HTML-демо модели состояний в одном файле или несколько разных вариантов интерфейса на одном маршруте с переключением через URL. Для случаев, когда нужно проверить логику или облик страницы.

Ретро сессии с агентом

Разбирает прошедшую сессию агента по логам и предлагает, что поменять в окружении: указатели в CLAUDE.md, правила линтера, pre-commit и CI, стандарты для ревью, вызовы инструментов. Для случаев, когда агент долго искал нужное или ошибался.

Спецификация из разговора

Собирает из текущего разговора и кода спецификацию с пользовательскими историями, решениями по реализации и тестам и публикует её в трекер с меткой ready-for-agent, без расспросов. Для случаев, когда фичу уже обсудили и её пора записать.

Разбивка спецификации на тикеты

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

Триаж задач и PR

Разбирает входящие задачи и внешние PR в трекере: ставит категорию и состояние, ищет готовый код и прошлые отказы, воспроизводит баги и пишет бриф для агента. Для случаев, когда мейнтейнер разгребает поток задач и PR.

Карта для большой работы

Раскладывает работу, которая не влезает в одну сессию агента, в карту в трекере с дочерними тикетами-решениями и закрывает по тикету за сессию, пока путь к цели не прояснится. Для случаев, когда большая задача упирается в нерешённые вопросы.

Bash-мастер для ручных шагов

Пишет интерактивный bash-скрипт, который ведёт человека по ручным шагам: открывает нужные страницы, принимает ключи и пишет их в .env и секреты GitHub. Для случаев, когда настройка сервисов или миграция требует действий, которые агент сам не сделает.

Защита от опасных git-команд в Claude Code

Ставит в Claude Code хук PreToolUse, который останавливает типовые формы git push, reset --hard, clean -f, branch -D и отката всего дерева, для одного проекта или для всех, и проверяет его. Для случаев, когда нужна страховка от того, что агент сам запушит или сотрёт работу.

Перевод тестов на shoehorn

Заменяет as и as unknown as в тестах на TypeScript на fromPartial и fromAny из @total-typescript/shoehorn, добавляет импорты и запускает проверку типов. Для случаев, когда тесты собирают объекты целиком или обманывают компилятор приведениями.

Настройка pre-commit хуков

Ставит Husky и lint-staged в Node-репозиторий: каждый коммит прогоняет Prettier по staged-файлам, проверку типов и тесты; учитывает менеджер пакетов и делает первый коммит через хук. Для случаев, когда в репозитории нет проверок при коммите.

Допрос плана

Допрашивает пользователя о плане раундами пронумерованных вопросов с рекомендуемым ответом, факты ищет сам через субагентов и не останавливается, пока остаются допущения. Для случаев, когда план надо проверить на прочность до начала работы.

Обучение новой теме

Ведёт курс по теме в текущей папке на много сессий: цель, проверенные источники, короткие HTML-уроки с тестами, шпаргалки и записи о выученном. Для случаев, когда тему нужно освоить всерьёз, а не получить один ответ.

Опросник для решения

Составляет Markdown-опросник для человека, у которого есть нужные знания, спросив только, кому он и какие ответы нужны; важные вопросы идут первыми. Для случаев, когда решение упирается в факты от другого человека.

Тексты для агентов: скиллы и AGENTS.md

Даёт правила для текстов, которые читает агент: описание скилла как указатель, что держать в файле и что выносить, критерии готовности, опорные слова и чистка. Для случаев, когда пишете или правите скилл, AGENTS.md или CLAUDE.md.