Que fait Triage Issue (Résolution de bug) ?
Enquêter sur un problème signalé, trouver sa cause racine et créer un ticket GitHub avec un plan de correction basé sur le TDD. Ce workflow est largement automatisé : minimisez les questions à l'utilisateur.
Processus
1. Capturer le problème
Obtenez une brève description du problème de la part de l'utilisateur. S'il n'en a pas fourni, posez UNE question : « Quel problème rencontrez-vous ? »
Ne posez PAS de questions supplémentaires pour l'instant. Commencez immédiatement l'investigation.
2. Explorer et diagnostiquer
Utilisez l'outil Agent avec subagent_type=Explore pour explorer en profondeur la base de code. Votre objectif est de trouver :
- Où le bug se manifeste (points d'entrée, interface utilisateur, réponses API)
- Quel chemin de code est impliqué (tracez le flux)
- Pourquoi il échoue (la cause racine, pas seulement le symptôme)
- Quel code connexe existe (schémas similaires, tests, modules adjacents)
Examinez :
- Les fichiers source concernés et leurs dépendances
- Les tests existants (ce qui est testé, ce qui ne l'est pas)
- Les modifications récentes des fichiers affectés (
git logsur les fichiers pertinents) - La gestion des erreurs dans le chemin de code
- Les schémas similaires ailleurs dans la base de code qui fonctionnent correctement
3. Identifier l'approche de correction
En fonction de votre investigation, déterminez :
- Le changement minimal nécessaire pour corriger la cause racine
- Les modules/interfaces affectés
- Les comportements qui doivent être vérifiés via des tests
- S'il s'agit d'une régression, d'une fonctionnalité manquante ou d'un défaut de conception
4. Concevoir le plan de correction TDD
Créez une liste concrète et ordonnée de cycles ROUGE-VERT. Chaque cycle représente une tranche verticale :
- ROUGE : Décrivez un test spécifique qui capture le comportement défectueux/manquant
- VERT : Décrivez le changement de code minimal pour que ce test passe
Règles :
- Les tests vérifient le comportement via des interfaces publiques, pas les détails d'implémentation
- Un test à la fois, tranches verticales (PAS tous les tests d'abord, puis tout le code)
- Chaque test doit survivre à des refontes internes
- Incluez une étape de refactoring finale si nécessaire
- Durabilité : Proposez uniquement des corrections qui survivraient à des changements radicaux de la base de code. Décrivez des comportements et des contrats, pas la structure interne. Les tests s'appuient sur des résultats observables (réponses API, état de l'interface utilisateur, effets visibles par l'utilisateur), pas sur l'état interne. Une bonne suggestion ressemble à une spécification ; une mauvaise ressemble à un diff.
5. Créer le ticket GitHub
Créez un ticket GitHub en utilisant gh issue create avec le modèle ci-dessous. NE demandez PAS à l'utilisateur de relire avant de créer - créez-le simplement et partagez l'URL.
Problème
Description claire du bug ou du problème, incluant :
- Ce qui se passe (comportement réel)
- Ce qui devrait se passer (comportement attendu)
- Comment reproduire (si applicable)
Analyse de la cause racine
Décrivez ce que vous avez trouvé lors de l'investigation :
- Le chemin de code impliqué
- Pourquoi le code actuel échoue
- Les éventuels facteurs contributifs
N'incluez PAS de chemins de fichiers spécifiques, de numéros de ligne ou de détails d'implémentation qui lient le ticket à la disposition actuelle du code. Décrivez plutôt les modules, les comportements et les contrats. Le ticket doit rester utile même après des refontes majeures.
Plan de correction TDD
Liste numérotée de cycles ROUGE-VERT :
-
ROUGE : Écrire un test qui [décrit le comportement attendu] VERT : [Changement minimal pour le faire passer]
-
ROUGE : Écrire un test qui [décrit le comportement suivant] VERT : [Changement minimal pour le faire passer]
...
REFACTOR : [Nettoyage nécessaire après que tous les tests passent]
Critères d'acceptation
- Critère 1
- Critère 2
- Tous les nouveaux tests passent
- Les tests existants passent toujours
Après avoir créé le ticket, affichez l'URL du ticket et un résumé d'une ligne de la cause racine.