writing-unit-tests — скилл для Claude Code: тесты и установка
Помогает писать и перерабатывать модульные тесты, проверяющие поведение, а не устройство кода. Пригодится для нестабильных и трудночитаемых тестов.
npx skills add riekelt/principal-engineer --skill writing-unit-tests -a claude-codeЧто делает writing-unit-tests
Скилл задаёт правила для модульных тестов: каждому тесту — отдельное поведение, а имя должно описывать проверяемый результат. Ожидаемое значение рассчитывают независимо от кода продукта. Тесты обращаются к публичному контракту, а не проверяют внутренние вызовы и состояние.
Для повторяемости скилл советует изолировать время, случайность, сеть и файловую систему, а мокировать границы с внешними ресурсами. Задержки в тестах заменяются ожиданием наблюдаемого условия с ограничением по времени. Скилл требует предварительно установить principal-engineering; правила testing-changes определяют, какие тесты нужны для изменения. Если тесты проверяют в основном моки, значит, проверяемый участок стоит расширить или вынести в интеграционный тест.
Какие задачи решает
- разделить проверки разных сценариев на отдельные тесты
- заменить ожидание через задержку проверкой условия
- убрать моки собственного кода из теста
- сделать тесты повторяемыми при работе со временем и случайностью
- проверить ожидаемый результат без копирования формулы из продукта
Примеры запросов агенту
- Перепиши этот модульный тест так, чтобы он проверял публичное поведение и имел ясное имя.
- Разбери нестабильный тест и замени ожидание через задержку проверкой условия.
- Добавь отдельные тесты для успешного сценария и типизированной ошибки.
Как установить writing-unit-tests
1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill writing-unit-tests -a claude-code2Вручную: положить файлы
~/.claude/skills/writing-unit-tests/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/writing-unit-tests/
1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill writing-unit-tests -a codex2Вручную: положить файлы
.agents/skills/writing-unit-tests/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill writing-unit-tests -a cursor2Вручную: положить файлы
.cursor/skills/writing-unit-tests/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install riekelt/principal-engineer writing-unit-tests2Вручную: положить файлы
.github/skills/writing-unit-tests/SKILL.md1Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill writing-unit-tests -a gemini-cli2Командой платформы
gemini skills install https://github.com/riekelt/principal-engineer --path plugins/principal-engineer/skills/writing-unit-testsВручную: положить файлы
.devin/skills/writing-unit-tests/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add riekelt/principal-engineer --skill writing-unit-tests -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о writing-unit-tests
Как установить writing-unit-tests в Claude Code?
Выполните npx skills add riekelt/principal-engineer --skill writing-unit-tests -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/writing-unit-tests/SKILL.md.
Что делает writing-unit-tests?
Помогает создавать модульные тесты с отдельной поведенческой проверкой в каждом тесте. Рекомендует проверять публичный контракт и использовать моки на границах с ресурсами, которыми код не владеет.
Что нужно установить перед использованием скилла?
Скилл требует предварительно установить principal-engineering. За выбор тестов, необходимых для конкретного изменения, отвечает testing-changes.
