principle-prove-it-works — скилл для Claude Code: что делает
Заставляет ИИ-агента проверять результат работы на реальных артефактах перед закрытием задачи. Пригодится, чтобы модель не отчитывалась об успехе только потому, что код скомпилировался.
npx skills add backnotprop/pstack --skill principle-prove-it-works -a claude-codeЧто делает principle-prove-it-works
Скилл запрещает агенту считать работу завершённой на основе косвенных признаков: времени изменения файлов или успешной сборки. Косвенные признаки часто обманывают. Вместо этого модель обязана напрямую запустить новую функцию, прочитать реальное значение и посмотреть дифф.
Инструкция требует по возможности автоматизировать проверку детерминированным скриптом. Повторяемый тест создаёт артефакт, который ревьюер сможет перезапустить сам, не веря агенту на слово. Сохранять такой скрипт в коммит имеет смысл при масштабных миграциях или сложном переносе кода.
Если проверка неожиданно провалилась, скилл обязывает сначала перепроверить метод наблюдения. Менять саму систему в этот момент нельзя. Это бережёт проект от лишних правок из-за кривого тестового вызова.
Какие задачи решает
- проверить результат задачи на реальном артефакте перед сдачей
- исключить закрытие тикетов на основании одной успешной компиляции
- написать детерминированный скрипт для воспроизводимой проверки изменений
- перепроверить инструмент наблюдения перед внесением правок в работающую систему
Примеры запросов агенту
- Примени principle-prove-it-works и проверь работу эндпоинта прямым запросом.
- Напиши отдельный скрипт для проверки полученного значения и покажи его вывод перед закрытием задачи.
Как установить principle-prove-it-works
1Через Skills CLI (Vercel)
npx skills add backnotprop/pstack --skill principle-prove-it-works -a claude-code2Вручную: положить файлы
~/.claude/skills/principle-prove-it-works/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/principle-prove-it-works/
1Через Skills CLI (Vercel)
npx skills add backnotprop/pstack --skill principle-prove-it-works -a codex2Вручную: положить файлы
.agents/skills/principle-prove-it-works/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add backnotprop/pstack --skill principle-prove-it-works -a cursor2Вручную: положить файлы
.cursor/skills/principle-prove-it-works/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install backnotprop/pstack principle-prove-it-works2Вручную: положить файлы
.github/skills/principle-prove-it-works/SKILL.md1Через Skills CLI (Vercel)
npx skills add backnotprop/pstack --skill principle-prove-it-works -a gemini-cli2Командой платформы
gemini skills install https://github.com/backnotprop/pstack --path skills/principle-prove-it-worksВручную: положить файлы
.devin/skills/principle-prove-it-works/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add backnotprop/pstack --skill principle-prove-it-works -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о principle-prove-it-works
Как установить principle-prove-it-works в Claude Code?
Выполните команду npx skills add backnotprop/pstack --skill principle-prove-it-works -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/principle-prove-it-works/SKILL.md.
Что делает скилл principle-prove-it-works?
Он запрещает агенту объявлять задачу выполненной без прямой проверки живого артефакта. Модель должна убедиться в работоспособности через запуск функции, чтение фактических данных или просмотр диффа.
Что делать по правилам скилла, если проверка не проходит?
Инструкция предписывает сначала усомниться в самом способе наблюдения, скрипте или тестовых данных. Править рабочий код системы разрешается только после подтверждения корректности проверки.
Исходный текст
SKILL.md · MIT
--- name: principle-prove-it-works description: "Apply after completing a task, before declaring done. Verify against the real artifact (run the feature, read the actual value, inspect the diff), not a proxy, self-report, or 'it compiles.'" disable-model-invocation: true --- # Prove It Works Verify every task output by checking the real thing directly. Do not infer from proxies, self-reports, or "it compiles." **Why:** Unverified work has unknown correctness. Indirect verification (file mtimes, output freshness, agent self-reports, cached screenshots) feels cheaper than direct observation. Acting on a wrong inference costs far more than checking the source. Check the real thing, not a proxy: - Check process liveness directly, not indirectly through derived state - Read the actual value, not a cached or derived representation - When verification fails, suspect the observation method before suspecting the system ## Script the check when you can The strongest proof is a deterministic script that re-runs the same comparison, not a one-time eyeball. Write the script, run it, and keep its output as an artifact a reviewer can re-run instead of trusting your word. Keep the artifact visible for the human. Commit it only for large or complex work where the trail has to be auditable later, like a big port or migration (the **show-me-your-work** skill).
© backnotprop · MIT · backnotprop/pstack