Session de débogage structurée — reproduire, isoler, diagnostiquer et corriger. À déclencher en cas de message d'erreur ou de trace de pile, de remarques telles que « cela fonctionne en environnement de test mais pas en production », « quelque chose ne fonctionne plus après le déploiement », ou lorsque le comportement s'écarte de ce qui est attendu et que la cause n'est pas évidente.
...Développer toutÀ propos debug
La compétence « debug » est conçue pour guider les utilisateurs à travers un processus d’ debuging structuré lorsque le comportement d’un logiciel est incorrect, peu clair ou a régressé. Elle est destinée aux situations où un message d’erreur, une trace de pile ou un comportement inattendu indique un problème qui ne peut pas être diagnostiqué immédiatement. En organisant le processus d’ debugage en phases claires, elle aide les utilisateurs à passer de l’observation des symptômes à l’identification de la cause première de manière systématique, plutôt que de se fier à des conjectures.
Cette compétence suit une méthodologie en quatre étapes : reproduction, isolation, diagnostic et correction. Au cours de la phase de reproduction, elle s’attache à clarifier le comportement attendu par rapport au comportement réel et à établir des étapes fiables permettant de reproduire le problème. La phase d’isolation permet de cerner les composants affectés en passant en revue les modifications récentes, telles que les déploiements, les mises à jour de configuration ou les changements de dépendances, tout en analysant les journaux et les messages d’erreur. Au cours du diagnostic, le processus met l’accent sur la formulation et la vérification d’hypothèses, le traçage des chemins d’exécution et l’identification de la cause première sous-jacente plutôt que des symptômes superficiels. Enfin, la phase de correction vise à proposer des modifications correctives tout en tenant compte des effets secondaires et en recommandant des tests préventifs pour éviter les régressions.
Cette compétence s’adresse principalement aux développeurs, aux ingénieurs DevOps, aux testeurs QA et aux ingénieurs en fiabilité des sites qui résolvent régulièrement des problèmes en production et en développement. Elle est particulièrement utile dans des scénarios tels que les régressions de déploiement, les bogues spécifiques à un environnement (par exemple, les différences entre l’environnement de préproduction et la production) ou les défaillances inexpliquées suite à des modifications récentes. En imposant une structure d’ debuging rigoureuse, elle réduit l’ debuging par essais et erreurs et améliore la cohérence des workflows de résolution des incidents.
FAQ
Quel type d’informations dois-je fournir pour utiliser cette compétence d’ debug?
Vous devez fournir un message d’erreur, une trace de pile, une description du comportement inattendu, les étapes de reproduction ou des éléments de contexte tels que les modifications récentes ou les journaux. Plus les informations sont précises, plus le processus d’ debugsera efficace.
Cette compétence nécessite-t-elle l’accès à des outils ou connecteurs externes ?
Elle peut, de manière facultative, utiliser les connecteurs disponibles, tels que les systèmes de surveillance, le contrôle de version ou les outils de suivi de projet, s’ils sont connectés. Cependant, elle peut tout de même fonctionner en utilisant uniquement la description, les journaux et le contexte fournis.
À quels types de problèmes cette compétence n’est-elle pas adaptée ?
Elle n’est pas destinée à répondre à des questions purement théoriques ni à fournir des explications générales. Elle est spécifiquement axée sur le diagnostic et la résolution de problèmes logiciels concrets présentant un comportement incorrect observable.
/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.
Installer debug
Téléchargez et décompressez les fichiers de compétences dans votre répertoire .claude/skills/.
Télécharger le ZIPClonez le dépôt et copiez les fichiers de compétence dans votre projet.
git clone https://github.com/anthropics/knowledge-work-plugins/blob/main/engineering/skills/debug/SKILL.md # Copy SKILL.md to your .claude/skills/ directory
Copier





Maison
