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