Pular pro conteúdo

Systematic Debugging skill

O agente para de chutar correção: investiga, acha a causa raiz, prova com um teste e só então conserta, uma coisa de cada vez.

por obra

instalações
307,8 mil
estrelas no GitHub
305,1 mil
No skills.sh desde
janeiro de 2026
Licença
MIT

Atualizada no GitHub em 23 de outubro de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

O que ela faz

A regra central é: nenhuma correção sem investigar a causa antes. Diante de qualquer erro, teste falhando, lentidão ou comportamento estranho, o agente lê a mensagem de erro inteira, reproduz o problema, vê o que mudou recentemente e, em sistemas com várias partes, põe registros em cada etapa pra ver onde quebra.

Depois compara com um trecho parecido que funciona, lista as diferenças e testa uma hipótese por vez, com a menor mudança possível. Achou a causa, escreve um teste que falha, aplica uma correção só e confere se nada mais quebrou.

Se três correções seguidas não resolveram, a skill manda parar e discutir com você se o problema está na estrutura do sistema, em vez de tentar a quarta. Ela também lista os pensamentos que denunciam chute, como "só uma correçãozinha rápida agora, investigo depois".

Nas palavras de quem fez

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes…

obra, no SKILL.md

Quando usar

  • Um erro que já levou duas ou três tentativas de correção sem resolver
  • Site ou automação que quebrou depois de uma atualização
  • Teste falhando ou build que não passa
  • Bug urgente, quando a tentação é chutar uma correção
  • Integração com pagamento, e-mail ou planilha que falha sem explicar por quê

Depois de instalar, é só pedir assim

  • O formulário de cadastro parou de salvar os leads. Investiga a causa antes de mudar qualquer coisa
  • Esse erro voltou depois da última correção. Usa a systematic-debugging e acha a causa raiz
  • O build falha só no servidor e no meu computador funciona. Descobre em que etapa quebra

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

  • Gen Agent Trust HubPassou
  • SocketPassou
  • SnykPassou

Perguntas

Como instalar a Systematic Debugging no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Systematic Debugging, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

Precisa de algum programa ou conta pra usar?

Não. É um método em texto, sem chave nem serviço pago. Rende mais num projeto em que o agente consiga rodar o código e os testes, pra reproduzir o erro e provar a correção.

Funciona no Codex e no Antigravity?

Sim, é um roteiro em texto que qualquer agente que leia skills consegue seguir. Ela chama outras skills do mesmo pacote, o Superpowers, como a de teste primeiro, então vale instalar junto.

Ela conserta o erro sozinha?

Conserta, mas só depois de achar a causa e ter um teste que reproduz o problema. Uma mudança por vez, sem "aproveitei e melhorei isso aqui". Se o problema vier do ambiente, de fora ou de ordem e tempo entre processos, ela registra o que investigou, põe nova tentativa, limite de tempo ou mensagem de erro e deixa registros pra investigar depois.

Levar essa skill

1x systematic-debuggingR$ 0,00

TotalR$ 0,00

A skill sai aqui mesmo, na hora. Seus dados eu uso pra falar com você sobre o MazyOS.

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/obra/superpowers

Aprenda a usar

Mais da loja obra

Ver a loja obra