Проверка перед словом «готово»

Не даёт агенту сказать «готово» или «тесты проходят», пока он заново не запустил проверку и не прочитал вывод целиком. Для случаев, когда агент докладывает об успехе, коммитит или открывает PR.

ТестированиеПак: Superpowers120 строкverification-before-completion
Автор
Источник
obra/superpowers/skills/verification-before-completion @ 22f0b46
Лицензия
MIT · Copyright (c) 2025 Jesse Vincent

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

Что делает

Скилл не даёт агенту говорить «готово», «починил» или «тесты проходят» без доказательств. Перед таким утверждением, коммитом, PR или следующей задачей он должен назвать команду, которая утверждение подтверждает, запустить её целиком прямо сейчас, прочитать весь вывод вместе с кодом выхода и только потом отчитаться — с результатом на руках. Прошлый прогон, «должно пройти» или слово субагента не считаются.

Скилл — один SKILL.md, в основном таблицы. Первая сопоставляет утверждение с доказательством: для сборки нужен код выхода 0, а не чистый линтер; для исправленного бага — повторная проверка исходного симптома; для регрессионного теста — проверка red-green (откатить исправление и увидеть, что тест падает); для работы субагента — diff в системе контроля версий. Остальные перечисляют отговорки агентов и слова, по которым видно непроверенное утверждение: «должно», «наверное» или «Отлично» до любого запуска. Сказать то же другими словами — всё равно утверждать.

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

Везде, где агент сам отчитывается о результатах: исправления, прогоны тестов, сборки, работа субагентов, планы, где каждое «готово» открывает следующий шаг. Особенно если вы уже ловили агента на успехе, который он не проверял.

Ничего не даёт, когда агент ничего не утверждает о работе: отвечает на вопрос или объясняет код. В проекте без тестов и сборки доказательств он не придумает — только заставит агента сказать, что проверить не удалось.

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

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

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

Пример: /verification-before-completion Прежде чем пушить, докажи, что фикс миграции работает: прогони тесты и сборку и покажи вывод.

Других скиллов он не вызывает; executing-plans принимает по нему каждую задачу плана, а systematic-debugging проверяет исправление перед отчётом.

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

Самопроверка перед PR из нашего каталога — чек-лист по diff: отладочный мусор, секреты, рамки задачи, тесты, миграции; правило «не утверждать, что тесты проходят, если не запускал их в этой сессии» там лишь один пункт из многих. Verification before completion превращает этот пункт в правило для каждого сообщения о статусе, а не только для того, что перед PR. Чек-лист релиза решает, можно ли выкатывать, и проверяет прод после выкатки; за тем, что агент утверждает по ходу работы, он не следит. Измеримая цель до начала работы заранее решает, каким доказательством подтвердится готовность; этот скилл требует свежего доказательства перед каждым утверждением. Разработка через сомнение берёт утверждения, которые прогоном тестов не проверишь, вроде «это безопасно» или «это масштабируется», и отдаёт их субагенту со свежим контекстом с заданием найти, что не так.

Установка

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

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

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

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

SKILL.md

Исходник

Verification Before Completion

Overview

Core principle: Evidence before claims, always.

Violating the letter of this rule is violating the spirit of this rule.

The Iron Law

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

If you haven't run the verification command in this message, you cannot claim it passes.

The Gate Function

BEFORE claiming any status or expressing satisfaction:

1. IDENTIFY: What command proves this claim?
2. RUN: Execute the FULL command (fresh, complete)
3. READ: Full output, check exit code, count failures
4. VERIFY: Does output confirm the claim?
   - If NO: State actual status with evidence
   - If YES: State claim WITH evidence
5. ONLY THEN: Make the claim

Skip any step = lying, not verifying

Common Failures

Claim Requires Not Sufficient
Tests pass Test command output: 0 failures Previous run, "should pass"
Linter clean Linter output: 0 errors Partial check, extrapolation
Build succeeds Build command: exit 0 Linter passing, logs look good
Bug fixed Test original symptom: passes Code changed, assumed fixed
Regression test works Red-green cycle verified Test passes once
Agent completed VCS diff shows changes Agent reports "success"
Requirements met Line-by-line checklist Tests passing

Red Flags - STOP

  • Using "should", "probably", "seems to"
  • Expressing satisfaction before verification ("Great!", "Perfect!", "Done!", etc.)
  • About to commit/push/PR without verification
  • Trusting agent success reports
  • Relying on partial verification
  • Thinking "just this once"
  • Tired and wanting work over
  • ANY wording implying success without having run verification

Rationalization Prevention

Excuse Reality
"Should work now" RUN the verification
"I'm confident" Confidence ≠ evidence
"Just this once" No exceptions
"Linter passed" Linter ≠ compiler
"Agent said success" Verify independently
"I'm tired" Exhaustion ≠ excuse
"Partial check is enough" Partial proves nothing
"Different words so rule doesn't apply" Spirit over letter

Key Patterns

Tests:

✅ [Run test command] [See: 34/34 pass] "All tests pass"
❌ "Should pass now" / "Looks correct"

Regression tests (TDD Red-Green):

✅ Write → Run (pass) → Revert fix → Run (MUST FAIL) → Restore → Run (pass)
❌ "I've written a regression test" (without red-green verification)

Build:

✅ [Run build] [See: exit 0] "Build passes"
❌ "Linter passed" (linter doesn't check compilation)

Requirements:

✅ Re-read plan → Create checklist → Verify each → Report gaps or completion
❌ "Tests pass, phase complete"

Agent delegation:

✅ Agent reports success → Check VCS diff → Verify changes → Report actual state
❌ Trust agent report

When To Apply

ALWAYS before:

  • ANY variation of success/completion claims
  • ANY expression of satisfaction
  • ANY positive statement about work state
  • Committing, PR creation, task completion
  • Moving to next task
  • Delegating to agents

Rule applies to:

  • Exact phrases
  • Paraphrases and synonyms
  • Implications of success
  • ANY communication suggesting completion/correctness

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

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

Ещё из пака Superpowers

Брейншторм перед работой

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

Параллельные субагенты

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

Выполнение плана по шагам

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

Завершение ветки разработки

Завершает ветку: прогоняет тесты, предлагает слить локально, открыть PR или оставить как есть, после слияния снова проверяет тесты и убирает свой worktree, а работу удаляет только после «discard». Для случаев, когда реализация готова.

Как принимать код-ревью

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

Запрос код-ревью

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

Разработка через субагентов

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

Системная отладка

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

TDD по методу Superpowers

Ведёт работу тестом вперёд: сначала тест и его падение, потом минимум кода и прогон всего набора; код, написанный до теста, удаляется. Для фич и багфиксов, когда агент норовит дописать тесты после кода.

Работа в git worktree

Выносит работу над фичей в отдельный git worktree: проверяет, не изолирован ли агент уже, предпочитает родной инструмент среды, следит за .gitignore, ставит зависимости и прогоняет тесты на старте. Для случаев, когда работа не должна попасть в текущую ветку.

План реализации перед кодом

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

Как писать скиллы

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