Проверка перед словом «готово»
Не даёт агенту сказать «готово» или «тесты проходят», пока он заново не запустил проверку и не прочитал вывод целиком. Для случаев, когда агент докладывает об успехе, коммитит или открывает PR.
verification-before-completion- Автор
- Jesse Vincent
- Источник
- 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 подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.
Скилл написан на английском — агент поймёт его и ответит вам по-русски.
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
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
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 }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 и других моделях по одному ключу — оплата за токены, без подписки.
AnyModel