Lar
Sessão de depuração estruturada — reproduzir, isolar, diagnosticar e corrigir problemas. Acione-a com uma mensagem de erro ou rastreamento de pilha, como “isso funciona no ambiente de teste, mas não no prod”, “algo falhou após a implantação”, ou quando o comportamento difere do esperado e a causa não é óbvia.
...Expandir tudoSobre a depuração
A habilidade de depuração foi desenvolvida para guiar os usuários através de um processo estruturado de resolução de problemas quando o comportamento do software é incorreto, indeciso ou sofre regressões. É destinada a situações em que uma mensagem de erro, rastreamento de chamadas ou comportamento inesperado indicam um problema que não pode ser diagnosticado imediatamente. Ao organizar o processo de depuração em fases claras, ajuda os usuários a passar da observação dos sintomas à identificação da causa raiz de forma sistemática, em vez de confiar apenas em suposições.
A habilidade segue um método de quatro etapas: reprodução, isolamento, diagnóstico e correção. Na fase de reprodução, o foco é esclarecer o comportamento esperado em comparação com o real e estabelecer passos confiáveis para reproduzir o problema. A fase de isolamento reduz os componentes afetados, analisando mudanças recentes como implantações, atualizações de configuração ou alterações em dependências, além de examinar logs e mensagens de erro. Durante o diagnóstico, é importante formular e testar hipóteses, rastrear caminhos de execução e identificar a causa raiz do problema, em vez de apenas os sintomas superficiais. Por fim, a fase de correção propõe alterações corretivas, considerando possíveis efeitos colaterais e recomendando testes preventivos para evitar regressões.
Esta habilidade é principalmente direcionada a desenvolvedores, engenheiros DevOps, testadores de qualidade e engenheiros de confiabilidade de sites que frequentemente resolvem problemas em ambientes de produção e desenvolvimento. É especialmente útil em situações como regressões após implantações, erros específicos do ambiente (por exemplo, diferenças entre ambientes de teste e produção) ou falhas inexplicáveis após mudanças recentes. Ao adotar uma estrutura disciplinada de depuração, reduz-se o tempo gasto em tentativas e erros e melhora a consistência nos processos de resolução de problemas.
Perguntas Frequentes
Que tipo de informações devo fornecer para usar esta habilidade de depuração?
Você deve fornecer uma mensagem de erro, um rastreamento de chamadas, uma descrição do comportamento inesperado, passos para reproduzir o problema ou contexto, como mudanças recentes ou logs. Quanto mais precisas forem as informações, mais eficaz será o processo de depuração.
Esta habilidade requer acesso a ferramentas ou conectores externos?
É possível utilizar conectores disponíveis, como sistemas de monitoramento, controle de código-fonte ou ferramentas de acompanhamento de projetos, se estiverem conectados. No entanto, ela também pode funcionar apenas com as informações fornecidas, logs e contexto.
Para que tipos de problemas esta habilidade não é adequada?
Não é indicada para questões puramente teóricas ou explicações gerais. É específica para diagnosticar e resolver problemas concretos no software que apresentam comportamentos incorretos observáveis.
/debug
If you see unfamiliar placeholders or need to check which tools are connected, see CONNECTORS.md.
Run a structured debugging session to find and fix issues systematically.
Usage
/debug $ARGUMENTSHow It Works
┌─────────────────────────────────────────────────────────────────┐│ DEBUG │├─────────────────────────────────────────────────────────────────┤│ Step 1: REPRODUCE ││ ✓ Understand the expected vs. actual behavior ││ ✓ Identify exact reproduction steps ││ ✓ Determine scope (when did it start? who is affected?) ││ ││ Step 2: ISOLATE ││ ✓ Narrow down the component, service, or code path ││ ✓ Check recent changes (deploys, config changes, dependencies) ││ ✓ Review logs and error messages ││ ││ Step 3: DIAGNOSE ││ ✓ Form hypotheses and test them ││ ✓ Trace the code path ││ ✓ Identify root cause (not just symptoms) ││ ││ Step 4: FIX ││ ✓ Propose a fix with explanation ││ ✓ Consider side effects and edge cases ││ ✓ Suggest tests to prevent regression │└─────────────────────────────────────────────────────────────────┘What I Need From You
Tell me about the problem. Any of these help:
- Error message or stack trace
- Steps to reproduce
- What changed recently
- Logs or screenshots
- Expected vs. actual behavior
Output
## Debug Report: [Issue Summary]### Reproduction- **Expected**: [What should happen]- **Actual**: [What happens instead]- **Steps**: [How to reproduce]### Root Cause[Explanation of why the bug occurs]### Fix[Code changes or configuration fixes needed]### Prevention- [Test to add]- [Guard to put in place]
If Connectors Available
If ~~monitoring is connected:
- Pull logs, error rates, and metrics around the time of the issue
- Show recent deploys and config changes that may correlate
If ~~source control is connected:
- Identify recent commits and PRs that touched affected code paths
- Check if the issue correlates with a specific change
If ~~project tracker is connected:
- Search for related bug reports or known issues
- Create a ticket for the fix once identified
Tips
- Share error messages exactly — Don't paraphrase. The exact text matters.
- Mention what changed — Recent deploys, dependency updates, and config changes are top suspects.
- Include context — "This works in staging but not prod" or "Only affects large payloads" narrows things fast.
Instalar debug
Baixe e extraia os arquivos de habilidades para o seu diretório .claude/skills/.
Baixar ZIPClone o repositório e copie os arquivos da habilidade para o seu projeto.
git clone https://github.com/anthropics/knowledge-work-plugins/blob/main/engineering/skills/debug/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Copiar
