{
  "id": "diagnosing-bugs",
  "handle": "diagnosing-bugs",
  "canonicalUrl": "https://bestskillsforclaude.com/pt-br/skills/diagnosing-bugs",
  "language": "pt-BR",
  "alternates": {
    "en": "https://bestskillsforclaude.com/en/skills/diagnosing-bugs",
    "es": "https://bestskillsforclaude.com/es/skills/diagnosing-bugs",
    "pt-BR": "https://bestskillsforclaude.com/pt-br/skills/diagnosing-bugs",
    "ja": "https://bestskillsforclaude.com/ja/skills/diagnosing-bugs"
  },
  "category": {
    "id": "build-and-ship",
    "name": "Construir e publicar"
  },
  "publisher": {
    "name": "Matt Pocock",
    "url": "https://github.com/mattpocock"
  },
  "source": "https://github.com/mattpocock/skills",
  "documentation": null,
  "licenseAsStated": "MIT",
  "runtime": "Claude Code and agents that support the skills CLI",
  "lastReviewed": "2026-08-05",
  "headline": "Por que a correção de um agente conserta tantas vezes a coisa errada?",
  "summary": "Porque existe uma correção plausível disponível muito antes de a causa ser entendida.",
  "verdict": "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.",
  "bestFor": "Bugs que já sobreviveram a uma tentativa de correção, e qualquer coisa intermitente.",
  "skipIf": "A falha é óbvia e local, onde a cerimônia custa mais do que economiza.",
  "keyTakeaways": [
    "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."
  ],
  "quickStart": [
    "Instale com o CLI de skills a partir de mattpocock/skills, sob MIT.",
    "Dê a observação, não a sua teoria: o que você esperava, o que aconteceu e como reproduzir.",
    "Exija uma causa declarada e evidência antes de aceitar qualquer mudança."
  ],
  "sections": [
    {
      "heading": "O que muda na prática",
      "paragraphs": [
        "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."
      ]
    },
    {
      "heading": "Onde decepciona",
      "paragraphs": [
        "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."
      ]
    }
  ],
  "faq": [
    {
      "question": "Qual a diferença de só pedir a correção?",
      "answer": "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."
    },
    {
      "question": "Devo contar minha teoria do bug?",
      "answer": "No começo não. Dê observações e uma reprodução, ou você recebe sua própria teoria confirmada de volta."
    },
    {
      "question": "Como se compara ao systematic-debugging?",
      "answer": "Mesma intenção, mais estrutura lá. Escolha uma para o agente receber um único conjunto de instruções."
    }
  ],
  "sources": [
    {
      "label": "mattpocock/skills no GitHub",
      "url": "https://github.com/mattpocock/skills",
      "kind": "repository"
    },
    {
      "label": "Diretório de agent skills",
      "url": "https://skills.sh",
      "kind": "directory"
    }
  ],
  "machineReadable": {
    "markdown": "https://bestskillsforclaude.com/pt-br/skills/diagnosing-bugs/content.md",
    "json": "https://bestskillsforclaude.com/pt-br/skills/diagnosing-bugs/skill.json"
  },
  "disclosure": "Editorial desk review based on the publisher's own repository. Not a security audit, a benchmark or a guarantee of maintenance."
}