Fiche de Reproduction de Bug

Utilisez cette compétence quand un rapport de bug est incomplet, intermittent, spécifique à un environnement, ou mélangé avec une cause supposée. L'objectif est de prouver la plus petite défaillance observable avant de commencer le diagnostic ou la réparation.

1. Enregistrer la défaillance observée

Capturez l'erreur exacte, la sortie incorrecte, l'horodatage, la route ou la commande affectée, et la plus petite entrée connue. Conservez les logs pertinents sans secrets ni données personnelles. Étiquetez les descriptions de seconde main comme non vérifiées.

2. Identifier l'environnement

Enregistrez uniquement les faits que vous pouvez inspecter :

repository et commit ;
versions du runtime et du gestionnaire de paquets ;
système d'exploitation ou conteneur ;
fichier de verrouillage des dépendances ;
feature flags pertinents ;
si la cible est locale, test, staging ou production.

Ne devinez jamais les identifiants ou la configuration de production.

3. Séparer le comportement attendu du comportement réel

Rédigez deux énoncés observables explicites :

Attendu : [résultat observable]
Réel :    [résultat observable, incluant le statut ou l'erreur]

Ne mettez pas la cause supposée dans l'un ou l'autre énoncé.

4. Réduire la reproduction

Partez du chemin rapporté, puis supprimez les données, services et étapes non liés un à la fois. Conservez le plus petit fixture qui échoue toujours. Si la défaillance s'arrête, restaurez la dernière condition supprimée et enregistrez-la.

Préférez un test isolé, un script minimal ou la plus petite requête sûre à une reproduction en production.

5. Prouver la reproductibilité

Exécutez la reproduction minimale au moins deux fois là où c'est sûr. Enregistrez les commandes et les sorties. Si la défaillance est intermittente, rapportez la fréquence et la durée observées au lieu de la qualifier de déterministe.

6. Arrêtez avant la réparation

Une reproduction vérifiée est le livrable. N'éditez pas le code d'implémentation lors de la construction de la fiche, car cela peut détruire la preuve ou mélanger diagnostic et remédiation.

Sortie

# Fiche de Reproduction de Bug

- Cible et commit :
- Environnement :
- Attendu :
- Réel :
- Étapes minimales :
- Fixture minimale :
- Reproduit : oui / non / intermittent
- Preuve :
- Inconnues :
- Prochaine hypothèse sûre à tester :

Limites de sécurité

Ne modifiez pas les données de production uniquement pour reproduire un bug.
Ne publiez pas les secrets, les enregistrements clients ou les sources privées.
Ne déclarez pas une cause racine à partir de la corrélation seule.
Utilisez d'abord la découverte en lecture seule ou réversible.
Arrêtez-vous après une reproduction vérifiée ; le diagnostic et la réparation sont des workflows distincts.

Exemple de prompt

Utilisez la compétence Fiche de Reproduction de Bug sur le test de paiement défaillant. Ne le réparez pas encore. Réduisez-le au plus petit fixture défaillant sûr et rapportez la preuve exacte de la commande, le résultat attendu, le résultat réel et les inconnues restantes.

Source et licence

Adapté du workflow sous licence MIT à https://github.com/skyestrela/ai-agent-skill-preview.

bug-reproduction-brief