Pular para o conteúdo
Skillpedia
Tarefas e projetos48 mil · #4493

verification-before-completion

Garante que o agente verifique o trabalho antes de declará-lo concluído. É útil para evitar alegações falsas de sucesso ou satisfação.

O que ela faz

Esta instrução garante que um agente de IA só diga que terminou um trabalho depois de realmente verificar se está tudo certo. Ele não deve dizer que algo está pronto sem antes checar as provas.

Quando usar

  • ✓Antes de dizer que um teste passou.
  • ✓Antes de afirmar que um código foi compilado com sucesso.
  • ✓Antes de declarar que um bug foi corrigido.

Exemplo do que pedir para a IA

“Verifique se todos os testes passaram antes de me dizer que o código está pronto.”

Quer saber mais? Abra as seções abaixo.

Como usar

O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.

Link da skill

https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/verification-before-completion/SKILL.md

Mensagem pronta para colar

Use esta skill para me ajudar: https://github.com/sickn33/agentic-awesome-skills/blob/main/plugins/agentic-awesome-skills-claude/skills/verification-before-completion/SKILL.md Leia o arquivo SKILL.md desse link e siga as instruções dele na minha tarefa.
Como funciona

A IA primeiro identifica qual comando precisa ser executado para provar que o trabalho está feito. Depois, ela executa esse comando e analisa o resultado para ter certeza de que tudo está correto antes de confirmar.

Instalação

Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.

No terminal (Claude Code, Codex, Cursor), na pasta do projeto:

npx skills add sickn33/agentic-awesome-skills --skill verification-before-completion

Ou baixe só o arquivo:

curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/verification-before-completion/SKILL.md -o SKILL.md
Conteúdo técnico (SKILL.md)

Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.

Verificação Antes da Conclusão

Visão Geral

Reivindicar que o trabalho está completo sem verificação é desonestidade, não eficiência.

Princípio central: Evidências antes das alegações, sempre.

Violar a letra desta regra é violar o espírito desta regra.

A Lei de Ferro

NO COMPLETION CLAIMS WITHOUT FRESH VERIFICATION EVIDENCE

Se você não executou o comando de verificação nesta mensagem, não pode afirmar que ela passou.

A Função de Portão

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

Falhas Comuns

Alegação Requer Não é Suficiente
Testes passaram Saída do comando de teste: 0 falhas Execução anterior, "deveria passar"
Linter limpo Saída do linter: 0 erros Verificação parcial, extrapolação
Build bem-sucedido Comando de build: saída 0 Linter passando, logs parecem bons
Bug corrigido Teste do sintoma original: passa Código alterado, assumido como corrigido
Teste de regressão funciona Ciclo vermelho-verde verificado Teste passa uma vez
Agente concluído Diferença do VCS mostra alterações Agente relata "sucesso"
Requisitos atendidos Checklist linha por linha Testes passando

Sinais de Alerta - PARE

  • Usar "deveria", "provavelmente", "parece"
  • Expressar satisfação antes da verificação ("Ótimo!", "Perfeito!", "Feito!", etc.)
  • Prestes a commitar/pushar/PR sem verificação
  • Confiar em relatórios de sucesso de agentes
  • Confiar em verificação parcial
  • Pensar "só desta vez"
  • Cansado e querendo terminar o trabalho
  • QUALQUER redação que implique sucesso sem ter executado a verificação

Prevenção de Racionalização

Desculpa Realidade
"Deveria funcionar agora" EXECUTE a verificação
"Estou confiante" Confiança ≠ evidência
"Só desta vez" Sem exceções
"Linter passou" Linter ≠ compilador
"Agente disse sucesso" Verifique independentemente
"Estou cansado" Exaustão ≠ desculpa
"Verificação parcial é suficiente" Parcial não prova nada
"Palavras diferentes, então a regra não se aplica" Espírito sobre a letra

Padrões Chave

Testes:

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

Testes de regressão (TDD Vermelho-Verde):

✅ 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)

Requisitos:

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

Delegação de agente:

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

Por Que Isso Importa

De 24 memórias de falha:

  • seu parceiro humano disse "não acredito em você" - confiança quebrada
  • Funções indefinidas enviadas - causariam falha
  • Requisitos ausentes enviados - recursos incompletos
  • Tempo perdido em conclusão falsa → redirecionamento → retrabalho
  • Viola: "Honestidade é um valor central. Se você mentir, será substituído."

Quando Usar

SEMPRE antes de:

  • QUALQUER variação de alegações de sucesso/conclusão
  • QUALQUER expressão de satisfação
  • QUALQUER declaração positiva sobre o estado do trabalho
  • Commitar, criação de PR, conclusão de tarefa
  • Mover para a próxima tarefa
  • Delegar para agentes

A regra se aplica a:

  • Frases exatas
  • Paráfrases e sinônimos
  • Implicações de sucesso
  • QUALQUER comunicação que sugira conclusão/correção

O Ponto Principal

Sem atalhos para verificação.

Execute o comando. Leia a saída. ENTÃO reivindique o resultado.

Isso é inegociável.

Quando Usar

Esta habilidade é aplicável para executar o fluxo de trabalho ou as ações descritas na visão geral.

Limitações

  • Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
  • Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
  • Pare e peça esclarecimentos se os inputs, permissões, limites de segurança ou critérios de sucesso necessários estiverem faltando.
Perguntas frequentes

Por que não posso simplesmente dizer que algo está pronto se acho que está?

Dizer que algo está pronto sem verificar é como mentir. Isso pode levar a erros, retrabalho e perda de confiança.

O que significa 'verificação fresca'?

Significa executar o comando de verificação novamente, agora, para ter certeza de que o resultado ainda é válido e não baseado em uma checagem antiga.

E se eu estiver com pressa?

Não há atalhos. A pressa não é uma desculpa para não verificar. Pular a verificação pode causar problemas maiores depois.

Detalhes

Descrição original do autor

Claiming work is complete without verification is dishonesty, not efficiency. Use when ANY variation of success/completion claims, ANY expression of satisfaction, or ANY positive statement about work state.

repo: sickn33/agentic-awesome-skills

Popularidade

Estrelas no GitHub
48 mil
Posição no ranking
#4493
Licença
MIT
Atualizada em
15/10/2026

Essa skill é útil?

0

Entre para votar.

Comentários

  • …

Mais skills deste repositório

Skills parecidas