# Por que a correção de um agente conserta tantas vezes a coisa errada?

Canonical URL: https://bestskillsforclaude.com/pt-br/skills/diagnosing-bugs
Language: pt-BR
Skill: diagnosing-bugs
Publisher: Matt Pocock (https://github.com/mattpocock)
Source: https://github.com/mattpocock/skills
License as stated by the publisher: MIT
Runtime: Claude Code and agents that support the skills CLI
Category: Construir e publicar
Last reviewed: 2026-08-05

Porque existe uma correção plausível disponível muito antes de a causa ser entendida.

## Short answer
A skill diagnosing-bugs separa diagnóstico de reparo: entender o que acontece, provar, e só então mudar código. Ela ataca diretamente a falha mais cara da depuração assistida por agentes, que é um patch confiante em um sintoma que esconde o defeito real.

Best for: Bugs que já sobreviveram a uma tentativa de correção, e qualquer coisa intermitente.
Skip it if: A falha é óbvia e local, onde a cerimônia custa mais do que economiza.

## What to remember
- Diagnosticar e reparar são trabalhos diferentes. Misturar é como correções de sintoma entram em produção.
- Entregar sua teoria cedo é o jeito mais rápido de tê-la confirmada em vez de testada.
- Peça a evidência que distingue essa causa da próxima mais provável.
- Sobrepõe systematic-debugging do superpowers. Teste as duas e fique com uma.

## O que muda na prática
Diante de um stack trace, um agente quase sempre produz uma mudança que faz o erro sumir. Isso não é consertar o defeito, e a diferença costuma aparecer uma semana depois com um erro mais estranho.
Exigir uma causa declarada antes da mudança torna o raciocínio inspecionável. Se a causa está errada, dá para ver na hora, o que é bem mais barato que descobrir por uma regressão.

## Onde decepciona
Ela não diagnostica o que não observa. Sem logs, sem reprodução e sem ambientes disponíveis, ela fica limitada como qualquer pessoa.
Em bugs triviais é mais lenta que simplesmente corrigir, então guarde para os que já custaram uma tarde.

## Install and first run
1. Instale com o CLI de skills a partir de mattpocock/skills, sob MIT.
2. Dê a observação, não a sua teoria: o que você esperava, o que aconteceu e como reproduzir.
3. Exija uma causa declarada e evidência antes de aceitar qualquer mudança.

## Questions
### Qual a diferença de só pedir a correção?
Ela exige causa declarada e com evidência antes de mudar código, então patch de sintoma fica visível em vez de silencioso.

### Devo contar minha teoria do bug?
No começo não. Dê observações e uma reprodução, ou você recebe sua própria teoria confirmada de volta.

### Como se compara ao systematic-debugging?
Mesma intenção, mais estrutura lá. Escolha uma para o agente receber um único conjunto de instruções.

## Sources
- mattpocock/skills no GitHub: https://github.com/mattpocock/skills
- Diretório de agent skills: https://skills.sh

## Other languages
- English: https://bestskillsforclaude.com/en/skills/diagnosing-bugs
- Spanish: https://bestskillsforclaude.com/es/skills/diagnosing-bugs
- Japanese: https://bestskillsforclaude.com/ja/skills/diagnosing-bugs