SkillProgramaçãoDiagnostica
Analisador de Logs de Debug
Transforma logs de erro, stack traces e relatórios de crash em um diagnóstico estruturado de causa raiz. Use quando alguém compartilha um log ou exceção e espera um diagnóstico real, não suposições vagas.
Ações
PerfilEngenharia
ProfundidadeAlta
IdiomaInglês (skill original)
Objetivo
Em uma frase.
Converter logs brutos, stack traces e relatórios de crash em um diagnóstico estruturado, com causa raiz provável, caminho de código afetado, correção sugerida e próximos passos concretos de investigação, evitando respostas evasivas do tipo "pode ser um null pointer".
Aplicação
Quando
faz sentido.
Usar
- O usuário cola um stack trace ou log de crash e espera um diagnóstico de verdade.
- Um incidente está em andamento e você precisa de uma primeira análise estruturada dos logs brutos.
- Um teste flaky falha de forma intermitente e é preciso mapear a propagação entre os frames.
- Chegou um bug report com logs anexados e é preciso fazer a triagem antes de reproduzir.
Não usar
- O bug já foi reproduzido e triado — use uma skill de implementação da correção.
- Análise de causa raiz longa para um postmortem de incidente — use postmortem-writing.
- Regressões de performance em que os logs estão limpos, mas o sistema está lento — use uma skill de profiling.
Prompt
Instruções
para a IA.
### Coletar as entradas
Peça, se faltarem: o log/stack trace/saída de erro, a linguagem e o framework, o contexto (o que o usuário estava fazendo), o ambiente (dev/staging/produção) e o que já foi tentado.
### Classificar e percorrer a stack
Classifique o erro (tipo, severidade, padrão de recorrência). Depois percorra a stack frame a frame, começando pela origem: identifique o frame de origem, o caminho de propagação e o ponto de crash. Para cada frame relevante, indique se é código do usuário (corrigível ali), de framework/biblioteca (geralmente uso incorreto) ou de sistema/runtime (geralmente configuração ou ambiente).
### Causa raiz, correção e prevenção
Declare a causa raiz provável em 1-2 frases, com nível de confiança e causas alternativas a descartar. Aponte o caminho de código afetado e os dados que dispararam o problema. Proponha uma correção mínima e concreta, em nível de código, explicando por que resolve a raiz. Se a causa for incerta, liste de 3 a 5 ações ordenadas de debug. Encerre com uma ou duas medidas de prevenção (validação de entrada, monitoramento, teste de cobertura).
### Armadilhas comuns
Não pare no topo da stack — o bug mora no frame de origem. Não confunda a exceção imediata (ex.: NullPointer) com a causa raiz. Evite sugerir "adicione try/catch" como correção: isso mascara o bug em vez de resolvê-lo.
Peça, se faltarem: o log/stack trace/saída de erro, a linguagem e o framework, o contexto (o que o usuário estava fazendo), o ambiente (dev/staging/produção) e o que já foi tentado.
### Classificar e percorrer a stack
Classifique o erro (tipo, severidade, padrão de recorrência). Depois percorra a stack frame a frame, começando pela origem: identifique o frame de origem, o caminho de propagação e o ponto de crash. Para cada frame relevante, indique se é código do usuário (corrigível ali), de framework/biblioteca (geralmente uso incorreto) ou de sistema/runtime (geralmente configuração ou ambiente).
### Causa raiz, correção e prevenção
Declare a causa raiz provável em 1-2 frases, com nível de confiança e causas alternativas a descartar. Aponte o caminho de código afetado e os dados que dispararam o problema. Proponha uma correção mínima e concreta, em nível de código, explicando por que resolve a raiz. Se a causa for incerta, liste de 3 a 5 ações ordenadas de debug. Encerre com uma ou duas medidas de prevenção (validação de entrada, monitoramento, teste de cobertura).
### Armadilhas comuns
Não pare no topo da stack — o bug mora no frame de origem. Não confunda a exceção imediata (ex.: NullPointer) com a causa raiz. Evite sugerir "adicione try/catch" como correção: isso mascara o bug em vez de resolvê-lo.
Constelação
Onde
ela vive.
Workflows que usam
Execução
Como usar
com IA.
- 01Copie a skill (botão "Copiar skill para IA", no topo): o texto copiado já é a skill completa, não um resumo.
- 02Abra o Claude ou Claude Code e cole — a IA recebe todas as instruções e fica pronta para a tarefa.
- 03Prefere usar como arquivo reutilizável? Baixe o .zip e coloque o
SKILL.mdem.claude/skills/(Claude Code) ou anexe o arquivo no Claude (claude.ai).