mtai0524/claude-skills

Débogage systématique qui trouve et corrige la cause racine plutôt que de masquer les symptômes. À utiliser pour tout bug, erreur, test échoué ou comportement inattendu.

Qu'est-ce que claude-skills ?

Cette compétence guide un agent IA (comme Claude Code) à travers un processus de débogage structuré en six étapes, conçu pour éliminer la cause racine des bugs plutôt que de simplement colmater les symptômes. Elle est utile pour tout développeur confronté à une erreur, un test qui échoue ou un comportement inattendu, quel que soit le langage ou le framework. La compétence force l'agent à reproduire l'erreur, à localiser précisément la source du problème dans le code via la stack trace, à formuler une hypothèse unique avant d'agir, à appliquer le correctif au niveau le plus partagé (par exemple en modifiant une fonction utilitaire plutôt que chaque appel), puis à prouver la correction avec un test ou une vérification manuelle. Elle interdit explicitement les mauvaises pratiques comme les `try/catch` aveugles ou les tentatives sans compréhension, garantissant ainsi des correctifs robustes et durables. Elle s'applique à tout projet logiciel, avec ou sans suite de tests automatisés.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mtai0524/claude-skills/tree/HEAD/skills/debug-root-cause

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Déboguer la cause racine

  1. Reproduire : obtenez l'erreur exacte, la stack trace et les étapes minimales qui la déclenchent. Si vous ne pouvez pas la reproduire, dites-le avant de deviner.
  2. Localiser : suivez la stack trace jusqu'à la ligne qui échoue, puis lisez en arrière jusqu'à l'endroit où l'état erroné a été créé.
  3. Hypothèse : énoncez une cause en une phrase. Vérifiez-la avec un log, un test ou en lisant le code. Pas de correctif avant que la cause ne soit confirmée.
  4. Corriger une fois, à la source : grep tous les appelants de la fonction que vous modifiez ; corrigez le code partagé, pas chaque site d'appel.
  5. Prouver : ajoutez ou exécutez un test qui échouait avant le correctif et qui réussit après, et relancez les tests connexes. Pas de projet de test : construisez le projet concerné et parcourez le cas d'échec dans le code.
  6. Rapporter : cause, correctif, comment il a été vérifié — trois lignes.

Ne jamais : masquer l'erreur, ajouter un try/catch aveugle ou réessayer sans comprendre pourquoi cela a échoué.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills associés