Cette compétence, issue de l'auteur original de superpowers, s'active en cas d'échec des tests, de panne en production, d'échec de la compilation ou de tout comportement anormal. La règle fondamentale est : « Aucune proposition de correction sans enquête sur la cause racine ». La première phase consiste à lire le message d'erreur complet, à reproduire le problème de manière stable et à examiner les modifications récentes ; pour les systèmes multi-composants, il faut ajouter des journaux à chaque frontière afin d'identifier le niveau où se produit la rupture. La deuxième phase consiste à trouver du code similaire fonctionnel et à le comparer point par point. La troisième phase vérifie une seule hypothèse à la fois. La correction n'intervient qu'en dernier lieu. Plus vous êtes pressé et plus vous pensez que « modifier une ligne suffit », plus il est impératif de suivre l'ensemble du processus.
Pourquoi c'est important Le défaut courant des agents qui corrigent des bugs est de modifier le code dès qu'ils observent un symptôme, puis d'ajouter une couche supplémentaire si la correction échoue. Cette compétence impose quatre étapes séquentielles obligatoires : l'enquête, la comparaison, la vérification des hypothèses et enfin la correction.
Installations sur skills.sh 333427 (+1239 / 24h)
Audit de sécurité : Avertissement de risque présent
- L'agent exécute des commandes shell / scripts
- Périmètre de l'audit : GitHub obra/superpowers/skills/systematic-debugging/SKILL.md (seul le texte SKILL.md est scanné)
Justification
- 1239 installations sur skills.sh en 24 heures, total cumulé de 333427 (indique uniquement l'attention portée) ; licence MIT
- Les commandes exécutées mentionnées dans l'avertissement d'audit sont
git diffet l'ajout de journaux pour le diagnostic, utilisés lors de la phase d'enquête, ce qui est cohérent avec l'usage prévu ; il s'agit du dépôt original de obra, et non d'un compte copié.
Utilisation
- Une fois installée, l'agent suit automatiquement les quatre phases pour diagnostiquer les erreurs ou les échecs de tests ; vous pouvez également demander directement : « Ne corrige pas encore, trouve la cause racine de ce problème ».
Risque
- Lors du diagnostic, des journaux de débogage temporaires sont ajoutés au code et des commandes sont exécutées ; il faut vérifier que ces modifications ont été nettoyées à la fin.