Le Bugfix Spec reproduit la façon dont les développeurs expérimentés abordent la correction de bogues : identifier la cause première, comprendre ce qui doit changer et préserver explicitement ce qui ne doit pas changer. Les Bugfix Specs offrent une approche structurée à partir de ce flux de travail, en vous guidant à travers l'analyse de la cause première, la conception du correctif et la prévention des régressions.
Correctifs ciblés - Des contraintes explicites garantissent que seuls les changements nécessaires sont apportés
Prévention des régressions - Le comportement inchangé est documenté et testé
Documentation - Un dossier complet du bogue, du correctif et du raisonnement pour référence future
Fiabilité - Un flux de travail structuré évite les pièges courants des correctifs improvisés
Idéal pour :
- Les bogues complexes nécessitant une analyse de la cause première
- Les bogues dans des chemins de code critiques où les régressions sont coûteuses
- Les bogues qui nécessitent une documentation pour la conformité ou le savoir de l'équipe
- Les situations où des tentatives de correctif antérieures ont causé des régressions
Les Bugfix Specs suivent le même flux de travail en trois phases que les Feature Specs (Exigences → Conception → Tâches), mais avec un contenu adapté spécifiquement aux corrections de bogues :
Au lieu d'un document d'exigences, vous créez un bugfix.md qui capture :
Comportement actuel (défaut)
- WHEN [condition] THEN the system [incorrect behavior]
Comportement attendu (correct)
- WHEN [condition] THEN the system SHALL [correct behavior]
Comportement inchangé (prévention des régressions)
- WHEN [condition] THEN the system SHALL CONTINUE TO [existing behavior]
Cette structure explicite garantit que Kiro comprend non seulement ce qui est brisé, mais aussi ce qui doit continuer à fonctionner.
Kiro explore la base de code pour déterminer la cause première du problème et génère un design.md avec :
- L'analyse de la cause première
- L'approche de correctif proposée
- Les propriétés à tester :
- L'implémentation actuelle produit un comportement incorrect (valide que le bogue existe)
- L'implémentation corrigée produit un comportement correct (valide que le correctif fonctionne)
- L'implémentation inchangée continue de fonctionner (empêche les régressions)
Les tâches d'implémentation sont générées avec des tests basés sur les propriétés (PBT) qui valident :
- Le bogue est reproductible
- Le bogue est corrigé
- Aucune régression n'est introduite
- Choisissez Bug Fix parmi les options de flux de travail sur l'écran « Let's build » au démarrage d'une nouvelle session. Pour changer en cours de session, cliquez sur le nom de l'agent dans la barre inférieure de la zone de saisie du clavardage et sélectionnez Bug Fix dans le sélecteur d'agent.
- Décrivez le bogue, y compris :
- Quand le bogue se produit (étapes de reproduction)
- Ce qui devrait se produire à la place
- Toute contrainte (code qui ne doit pas être modifié)
- Suivez le flux de travail à travers l'analyse, la conception et l'implémentation.
Bugfix Specs