debug

Par anthropics · knowledge-work-plugins

Session de débogage structurée — reproduire, isoler, diagnostiquer et corriger. À déclencher avec un message d'erreur ou une stack trace, « ça marche en staging mais pas en prod », « quelque chose a cassé après le déploiement », ou quand le comportement diverge de ce qui est attendu sans que la cause soit évidente.

npx skills add https://github.com/anthropics/knowledge-work-plugins --skill debug

/debug

Si vous voyez des placeholders inconnus ou avez besoin de vérifier quels outils sont connectés, consultez CONNECTORS.md.

Exécutez une session de débogage structurée pour trouver et corriger les problèmes de manière systématique.

Usage

/debug $ARGUMENTS

How 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

Décrivez le problème. N'importe lequel de ces éléments aide :

  • Message d'erreur ou stack trace
  • Étapes de reproduction
  • Ce qui a changé récemment
  • Logs ou captures d'écran
  • Comportement attendu vs. réel

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

Si ~~monitoring est connecté :

  • Récupérez les logs, les taux d'erreur et les métriques autour du moment du problème
  • Affichez les déploiements récents et les changements de configuration qui peuvent être corrélés

Si ~~source control est connecté :

  • Identifiez les commits et PRs récents qui ont touché les chemins de code affectés
  • Vérifiez si le problème est corrélé à un changement spécifique

Si ~~project tracker est connecté :

  • Recherchez les rapports de bugs connexes ou les problèmes connus
  • Créez un ticket pour la correction une fois identifiée

Tips

  1. Partagez les messages d'erreur exactement — Ne paraphrasez pas. Le texte exact compte.
  2. Mentionnez ce qui a changé — Les déploiements récents, les mises à jour de dépendances et les changements de configuration sont les suspects principaux.
  3. Incluez du contexte — « Cela fonctionne en staging mais pas en prod » ou « Affecte uniquement les grands payloads » réduit les possibilités rapidement.

Skills similaires