SKILL.md
Debug - Analyse et Résolution d'Erreurs
Instructions à Exécuter
IMPORTANT : Exécute ce workflow étape par étape :
Analyser une erreur (message ou stack trace) et proposer/appliquer résolution.
Variables
- ERROR_INPUT: $ARGUMENTS
- ERROR_TYPE: Type détecté (simple message vs stack trace)
- CONTEXT_FILES: Fichiers pertinents
- RESOLUTION_PLAN: Plan structuré si résolution demandée
Détection Automatique
Le système détecte automatiquement :
- Stack trace : Parsing + formatage + analyse approfondie
- Message simple : Analyse directe + diagnostic
Patterns stack trace :
Fatal error:,Uncaught,Exception,Error:- Présence de
at <file>:<line> - Multiple lignes avec indentation/numéros
Workflow
1. Identification Type
Si stack trace détectée :
- Parser trace (type, message, fichier:ligne, call stack)
- Formater hiérarchiquement
- Lire code source ligne incriminée
- Générer rapport
/tmp/stack-trace-analysis-[timestamp].md
Si message simple :
- Catégoriser (syntaxe, runtime, logique, config)
- Extraire infos contextuelles
2. Analyse Contexte
- Examiner fichiers mentionnés
- Analyser logs récents corrélés
- Vérifier environnement (deps, config)
- Identifier changements récents (git)
3. Diagnostic
- Cause racine vs symptômes
- Impact et criticité
- Solutions possibles + trade-offs
- Priorisation
4. Solutions
Stack trace : 3 niveaux
- Quick Fix ⚡ : Rapide, symptôme
- Recommandée ✅ : Équilibrée, cause
- Long-terme 🎯 : Robuste, prévention
Message simple : Plan résolution
- Étapes séquencées
- Tests validation
- Rollbacks prévus
- Risques estimés
5. Exécution (optionnel)
Si utilisateur demande résolution :
- Appliquer corrections pas à pas
- Valider chaque modif
- Vérifier résolution complète
- Documenter changements
Exemples
# Stack trace PHP
/dev:debug "Fatal error: Call to undefined method User::getName()"
# Fichier log
/dev:debug /var/log/app.log
# Message NPM
/dev:debug "npm ERR! missing script: build"Best Practices
- Détecter type avant traiter
- Parser intelligemment selon langage
- Lire code source pour contexte
- Solutions testables avec exemples
- Corrections incrémentales si exécution
- Validation systématique après chaque change