Passer au contenu principal
Afficher en Markdown

Bugfix Specs

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.

Principaux avantages

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

Quand utiliser les Bugfix Specs

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

Comment ça fonctionne

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 :

Loading diagram...

1. Phase d'analyse du bogue

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.

2. Phase de conception

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)

3. Phase des tâches

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

Pour commencer

  1. 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.
  2. 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é)
  3. Suivez le flux de travail à travers l'analyse, la conception et l'implémentation.

En savoir plus

Page mise à jour : 27 août 2026