Debug Sistemático no Contexto DEILE
Use esta skill ao encontrar comportamento inesperado em qualquer componente DEILE. O objetivo é chegar à causa raiz com evidências em código antes de propor qualquer fix.
Princípio Central
Comentário não é prova, o código é. Cada afirmação sobre como algo funciona
deve citar arquivo:linha. Hipóteses sem citação são suposições.
Checklist
- Reproduza o problema — qual é o input exato e o output observado?
- Delimite o escopo — qual componente (
deile/core/,deile/orchestration/, etc.) está envolvido? - Forme hipóteses — liste 2-3 causas possíveis, ordenadas por probabilidade.
- Refute ou confirme cada hipótese lendo o código (não suponha):
- Leia a função suspeita completa
- Trace o fluxo de chamada (quem chama quem)
- Verifique os testes existentes que cobrem esse caminho
- Identifique a causa raiz com
arquivo:linhaexplícito. - Proponha o fix mínimo que resolve a causa raiz (não a sintoma).
- Escreva o teste que reproduz o bug antes de aplicar o fix.
Atalhos DEILE
deile/config/settings.py— ponto único de configuração; verifique o valor efetivo antes de debugar comportamento de configdeile/core/agent.py— loop central do agente; trace vialogging.DEBUGinfra/k8s/wrapper.py— bootstrap do pod; primeiro lugar para problemas de inicialização- Logs:
/home/deile/logs/(deile-worker) oukubectl logs <pod>para stdout
Anti-padrões a evitar
- Adicionar
try/exceptsem entender o erro - "Funciona na minha máquina" sem verificar env vars / ConfigMap
- Fix no sintoma sem identificar causa raiz
- Mudar código sem escrever teste que reproduz o bug