К основному содержанию
скилл CX Codex

principle-prove-it-works — скилл для Claude Code: что делает

Заставляет ИИ-агента проверять результат работы на реальных артефактах перед закрытием задачи. Пригодится, чтобы модель не отчитывалась об успехе только потому, что код скомпилировался.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add backnotprop/pstack --skill principle-prove-it-works -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/principle-prove-it-works/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/principle-prove-it-works/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Всё по теме «Тесты и QA» →
principal-engineering riekelt Скилл задаёт строгие инженерные правила перед правками: запрещает заглушать ошибки, требует чекпоинт рисков и проверку работы реальным кодом, а не догадками. CX Codex +1 18 000установок audit-verify-explain-grade-5 MengTo Скилл заставляет агента проверить работу по фактам, а потом объяснить результат простыми словами. Пригодится, когда нужно разобрать чужой фикс или отчёт о тестах. CX Codex +1 1 400установок verification-gate sentimony Скилл не даёт объявить работу законченной без свежих доказательств: собирает матрицу проверок и выносит вердикт по конкретному набору утверждений. CX Codex +1 836установок verify Yeachan-Heo Скилл превращает «должно работать» в проверяемые доказательства: что запускали, что прошло, что осталось непроверенным. CX Codex +1 647установок improve-code-quality wondelai Пошагово переводит сырой прототип в рабочий проект с тестами, границами архитектуры и планом надёжности. Пригодится, когда страшно трогать работающий код без тестов. CX Codex +1 2 300установок general-best-practices Mindrally Скилл задаёт агенту свод правил по качеству кода, тестам, безопасности и архитектуре. Пригодится, когда нужно, чтобы ИИ писал код в одном стиле во всём проекте. CX Codex +1 794установок

Из того же набора44

interrogate Скилл поручает независимым моделям проверить изменения в коде и сводит их замечания в общий вердикт. Подходит для поиска ошибок и слепых зон перед ревью. CX Codex +1 5 500установок arena Запускает несколько параллельных попыток на одну задачу, оценивает их по рубрике и переносит сильные куски проигравших в выбранную базу. CX Codex +1 5 500установок create-verification-skill Генерирует локальный скилл верификации для репозитория, проверяя работу веб-интерфейса, CLI или сервиса по реальным сценариям пользователя. CX Codex +1 5 300установок poteto-mode Задаёт агенту стиль poteto: короткие ответы с деталями, осознанные субагенты, простой код и проверенная работа. CX Codex +1 5 400установок swarm Разворачивает N параллельных воркеров на одну задачу, собирает результаты и возвращает один сводный отчёт. Пригодится для покрытия кода, гонок моделей и разведки. CX Codex +1 5 200установок setup-pstack Прописывает pstack, какая модель идёт на каждую роль и с каким бюджетом рассуждений, а потом кладёт это в правило-файл, который перекрывает умолчания скиллов. CX Codex +1 5 300установок principle-type-system-discipline Задаёт правила строгой типизации: брендирование примитивов, парсинг данных на границах и генерация типов из схем. CX Codex +1 5 300установок show-me-your-work Ведёт проверяемый журнал решений для долгих и автономных запусков. Нужен, когда результат будет изучать другой человек. CX Codex +1 5 300установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой