SkillProgramaçãoDiagnostica

Instrumentação de Sondas de Debug

Adiciona probes temporários e direcionados para distinguir hipóteses de causa raiz.

Em:Investigação Sistemática de Bugs
Ações
PerfilDev
ProfundidadeAlta
IdiomaPortuguês
Objetivo

Em uma frase.

Coletar evidência precisa para confirmar ou derrubar hipóteses de causa raiz, sem transformar o codebase em ruído de logs ou alterar comportamento de produção inadvertidamente.

Aplicação

Quando
faz sentido.

Usar
  • Quando a reprodução existe, mas a causa ainda está entre múltiplas camadas.
  • Quando o erro aparece longe da origem do dado inválido.
  • Quando a falha atravessa API, serviço, banco, fila, cache ou UI.
  • Em regressões de performance que exigem medição objetiva.
Prompt

Instruções
para a IA.

Passo 1 - Mapear a fronteira que separa as hipóteses

Identifique o menor ponto onde a hipótese faz uma previsão diferente das alternativas: entrada de função, payload antes de persistir, query gerada, resposta de API, estado de cache, tempo de execução ou output renderizado.

### Passo 2 - Escolher o tipo de probe

Use a opção menos invasiva:

- Debugger ou inspeção interativa quando disponível.

- Log temporário com prefixo único. - Medição de tempo ou perfil para performance. - Query plan ou métrica de banco para gargalos. - Snapshot de payload antes/depois em fronteiras. - Assert temporário em harness local.

Passo 3 - Marcar para remoção

Todo log temporário deve ter prefixo único, por exemplo [DEBUG-gzero-20260505]. Registre o prefixo para busca posterior.

### Passo 4 - Rodar e interpretar

Execute o loop uma vez por probe. Registre:

- Valor observado.

- Previsão esperada. - Hipótese confirmada, enfraquecida ou descartada. - Próximo experimento se necessário.
Constelação

Onde
ela vive.

Workflows que usam
Bundles que incluem
Execução

Como usar
com IA.

  1. 01Copie a skill (botão "Copiar skill para IA", no topo): o texto copiado já é a skill completa, não um resumo.
  2. 02Abra o Claude ou Claude Code e cole — a IA recebe todas as instruções e fica pronta para a tarefa.
  3. 03Prefere usar como arquivo reutilizável? Baixe o .zip e coloque o SKILL.md em .claude/skills/ (Claude Code) ou anexe o arquivo no Claude (claude.ai).