Un modèle de rapport de bogue pour le comportement de l'IA
- Leçon 12
- 35 min
- Module 4 : Rédiger des rapports de bogue utiles aux personnes
Où nous en sommes
Dans les deux leçons précédentes, nous avons recueilli des preuves et évalué la gravité de chaque bogue. Mais des preuves dans vos notes n'aident personne tant qu'elles ne sont pas dans un rapport qu'un développeur peut suivre seul. Dans cette leçon, nous écrivons ce rapport avec le modèle du cours, et nous le testons avec un lecteur externe.
Leçon 12 sur 24 · Tester les applications d'IA : assurance qualité manuelle et assistée par l'IAUn modèle de rapport de bogue pour le comportement de l'IA
1. Comment les fonctions d'IA échouent
2. Planifier et juger sans une seule bonne réponse
3. Explorer et reproduire
4. Rédiger des rapports de bogue utiles aux personnes
5. Rédiger des rapports qu'un agent de programmation peut corriger
6. Tester la recherche, les agents et la sécurité
7. Assurance qualité assistée par l'IA et protection contre les régressions
Ce que vous saurez faire
Rédigez un rapport de bogue qu’un développeur absent de votre session peut utiliser sans votre aide. Utilisez le modèle de rapport de bogue du cours. Il comprend un résumé, les étapes, le résultat réel et le résultat attendu sous forme de règles vérifiables. Il comprend aussi le taux de reproduction et une couche soupçonnée. Excluez les secrets et les données personnelles.
Avant de commencerCe qu’il faut savoir et avoir sous la main
Ce que vous devez savoir
- Le dossier de preuves et les exports de Recueillir les preuves.
- La gravité, la priorité et les notes de tri de Gravité et tri pour « parfois faux ».
- Les règles vérifiables pour une réponse, présentées dans Grilles d’évaluation et vérifications de propriétés.
Ce qu’il vous faut sur votre ordinateur
- Votre dossier de cours
ai-qa: l’application danspractice-app, les modèles danstemplates, votre travail dansworkspace. - Un terminal ouvert dans
ai-qa/practice-app, avec l’environnement virtuel activé.
Testé sur macOS (Apple silicon) avec Python 3.14.6. Les commandes Windows ont été rédigées, mais pas exécutées.
Une recette pour un ami
Section intitulée « Une recette pour un ami »Un ami vous demande votre recette de gâteau. Vous écrivez : « De la farine, du sucre, trois œufs. Faites cuire jusqu’à ce que ce soit prêt. » Vous faites ce gâteau chaque semaine, alors cela vous suffit. Le gâteau de votre ami reste plat. Quelle farine? Quelle quantité? À quelle température faut-il régler le four? Comment savoir si le gâteau est « prêt »?
Une bonne recette fonctionne pour une personne qui ne vous a jamais vu cuisiner. Elle indique « 250 g de farine » et « 180 °C pendant 25 minutes ». Elle explique aussi comment vérifier le résultat : « le dessus est doré et un couteau en ressort propre ». Votre ami peut la suivre seul. Il sait si le gâteau est réussi sans vous le demander.
Un rapport de bogue est une recette pour reproduire une défaillance. Le développeur doit provoquer la même défaillance et savoir quand elle est corrigée.
Le problème : un rapport que seule sa rédactrice comprend
Section intitulée « Le problème : un rapport que seule sa rédactrice comprend »Regardez encore BL-104 dans la liste des tâches : « Parfois, le robot dit 30 jours pour les retours. Je pense que ce devrait être 45 maintenant. Pas certaine. » Pour sa rédactrice, une responsable de l’équipe de soutien, c’était clair. Elle avait vu les conversations. Pour Tomás, c’est un gâteau plat. Il ne peut pas reproduire le problème : il n’y a aucune étape. Il ne peut pas vérifier une correction : « ce devrait être 45 maintenant, pas certaine » n’est pas une règle. Il ne peut pas non plus juger l’urgence : « parfois » n’est pas un taux.
L’image place BL-104 à côté du rapport qu’Esme a rédigé pour le même bogue. Chaque partie de BL-104 devient une partie du nouveau rapport. Quatre parties du nouveau rapport n’ont aucun équivalent dans BL-104.
Description textuelle du diagramme
À gauche, BL-104 contient quatre phrases. À droite, BUG-002 contient huit parties.
« Délai de retour incorrect? » devient le résumé : la réponse sur le délai de retour utilise la politique expirée, dans 4 essais sur 20. « Parfois » devient le taux de reproduction : 4 essais sur 20, valeurs de départ 2, 8, 11 et 14, simulés. « Le robot dit 30 jours pour les retours » devient le résultat réel : la réponse mot pour mot, sa source et l’identifiant de trace. « Je pense que ce devrait être 45 maintenant. Pas certaine. » devient le résultat attendu. La réponse doit dire 45 jours et citer la version 4. Elle ne doit pas dire 30 jours.
Quatre parties n’ont aucun équivalent dans BL-104, comme le montre l’encadré rouge en pointillés. Les versions et paramètres : application 2.3.0, requête support-v8, modèle sim-1, valeur de départ 2, client de test C-1001. Les étapes : réinitialiser, puis poser la question exacte avec –seed 2. Les preuves : l’export evidence/bug-002-seed2.json. Et la couche soupçonnée : la récupération, une hypothèse, car la recherche a trouvé les deux versions. Sans ces quatre éléments, un développeur ne peut pas reproduire le bogue.
La responsable du soutien n’a pas été négligente : personne ne lui avait donné de formulaire. Un modèle règle ce problème.
L’idée : un modèle, une question par section
Section intitulée « L’idée : un modèle, une question par section »Un modèle de rapport de bogue est une liste fixe de sections. Chaque section répond à une question que le développeur vous poserait autrement. Vous remplissez chaque section, chaque fois. Rien ne dépend donc de votre mémoire.
Le modèle du cours se trouve dans votre dossier de cours : ai-qa/templates/bug-report.md. Vous pouvez le copier et le modifier librement, même au travail (licence CC0). Voici ses sections et la question à laquelle chacune répond :
| Section | Question du développeur |
|---|---|
| Titre (le résumé) | Qu’est-ce qui fonctionne mal, où et à quelle fréquence? |
| Version, client de test | Quelle version de l’application a répondu, et pour quel utilisateur? |
| Gravité, priorité | Quelle est la gravité du problème, et dans quel délai faut-il le corriger? |
| Étapes de reproduction | Comment provoquer le problème? |
| Résultat réel | Qu’avez-vous vu exactement? |
| Résultat attendu | Comment savoir que le problème est corrigé? |
| Taux de reproduction | À quelle fréquence, sur combien d’essais? |
| Preuves | Que puis-je rejouer? |
| Notes | Où pensez-vous que le problème commence, et pourquoi? |
Deux sections sont nouvelles par rapport à un rapport pour un logiciel ordinaire. Le taux de reproduction existe parce qu’une fonction d’IA échoue dans certains essais, mais pas dans d’autres. La couche soupçonnée existe parce qu’une même réponse incorrecte peut provenir de la recherche, de la requête, du modèle ou des outils.
Exemple détaillé : Esme rédige BUG-002
Section intitulée « Exemple détaillé : Esme rédige BUG-002 »Esme transforme BL-104 et son dossier de preuves en rapport. Rédigez-le avec elle.
-
Copiez le modèle dans votre espace de travail. Choisissez un nom qui indique l’identifiant du bogue et ce qui fonctionne mal :
Fenêtre de terminal cp ../templates/bug-report.md ../workspace/bugs/BUG-002-outdated-returns-policy.mdFenêtre de terminal Copy-Item ..\templates\bug-report.md ..\workspace\bugs\BUG-002-outdated-returns-policy.mdFenêtre de terminal cp ../templates/bug-report.md ../workspace/bugs/BUG-002-outdated-returns-policy.md -
Ouvrez le fichier dans votre éditeur. Les commentaires
<!-- ... -->expliquent chaque partie. Supprimez-les quand vous avez terminé.
Remplissez-le maintenant, section par section.
Le titre est le résumé. Suivez ce modèle : ce qui fonctionne mal, où, à quelle fréquence. « Délai de retour incorrect? » nomme un sujet. « La réponse sur le délai de retour utilise parfois la politique de retour expirée (30 jours, version 3), 4 essais sur 20 » nomme le comportement, la fonction et le taux. Dans une liste de 50 bogues, un développeur reconnaît celui-ci grâce à son titre.
Version, client de test, gravité et priorité. Copiez les versions et les paramètres de votre dossier de preuves. Indiquez la gravité et sa justification selon la matrice : « élevée : préjudice moyen (un client pourrait abandonner un retour valide); parfois (4 essais sur 20) ». Laissez la priorité à « à définir au tri » jusqu’à ce qu’elle soit décidée en réunion.
Étapes de reproduction. Commencez par reset (réinitialiser), pour que le développeur ait les mêmes données que vous. Collez ensuite la commande exacte, avec les mots exacts et la valeur de départ. Ne retapez jamais la question.
Résultat réel. Collez la réponse mot pour mot, ou la partie pertinente, avec sa source. Ajoutez ensuite l’identifiant de trace et ce que la trace montre : les champs qui expliquent la défaillance, pas les 60 lignes.
Résultat attendu, sous forme de règles vérifiables. C’est la section que la plupart des rapports rédigent mal. « La réponse devrait donner le bon délai de retour » n’est pas une règle : deux personnes peuvent comprendre « bon » différemment. Rédigez des règles avec Doit et Ne doit pas que tout le monde vérifie de la même façon :
- Doit : dire « 45 jours » et citer la politique de retour, version 4.
- Ne doit pas : dire « 30 jours » ou citer la version 3, qui a pris fin le 31 octobre 2026.
Ce sont les mêmes règles que vous avez inscrites dans cases/bugs.yaml : contains: 45 days (contient : 45 jours) et not_cites: returns-policy@3 (ne cite pas : returns-policy@3). Une règle qu’une personne peut vérifier est aussi une règle que l’outil d’exécution des tests peut vérifier.
Taux de reproduction. Indiquez x essais sur y, les valeurs de départ en échec et la mention « simulés » ou « enregistrés ». Ajoutez l’identifiant du cas, pour que n’importe qui puisse l’exécuter à nouveau.
Preuves. L’export et l’identifiant de trace. Indiquez que la relecture donne la même réponse.
Notes : la couche soupçonnée. La trace indique souvent une partie de l’assistant, ce qui fait gagner du temps au développeur. Présentez-la comme une hypothèse, avec sa justification : « Couche soupçonnée (une hypothèse) : récupération. La recherche renvoie la version 3 expirée avec le même score que la version 4. » Les couches sont les parties de l’assistant : la récupération (la recherche), la requête, le modèle, les outils et autorisations, et le code de l’application. Si votre hypothèse est fausse, le mot « hypothèse » et la justification permettent au développeur de comprendre pourquoi et de poursuivre. Recherche ou génération ? montre comment déterminer la couche à l’aide de preuves.
L’image montre le rapport terminé, avec le rôle de chaque partie.
Description textuelle du diagramme
De haut en bas : le titre est le résumé, qui indique ce qui fonctionne mal, où et à quelle fréquence. Les lignes de version donnent les trois versions, la date de l’application et le client de test. Elles indiquent quelle version de l’application a répondu et comment l’exécuter à nouveau. La gravité dépend du préjudice et de la fréquence; la priorité vient du tri.
Les étapes commencent par une réinitialisation. Elles donnent ensuite l’entrée exacte et la valeur de départ, copiées et non retapées. Le résultat réel est présenté mot pour mot, avec l’identifiant de trace et ce que la trace montre. Le résultat attendu est un ensemble de règles que deux personnes vérifient de la même façon.
Le taux de reproduction indique x essais sur y, les valeurs de départ en échec et si les essais étaient simulés ou enregistrés. Les preuves comprennent l’export à joindre, qui rejoue la même réponse. Les notes donnent une hypothèse clairement indiquée sur la couche, avec sa justification.
Voici le rapport complet. Votre fichier devrait ressembler à ceci.
# BUG-002: The return window answer sometimes uses the expired returns policy (30 days, version 3), 4 of 20 runs
From backlog report BL-104 ("Return days wrong?").
- **Version:** app 2.3.0, prompt support-v8, model sim-1 (simulated); app date 2026-11-16- **Test customer:** C-1001- **Severity:** high: medium harm (a customer may give up a valid return or miss 15 days of return rights); sometimes (4 of 20 runs)- **Priority:** P1 (triage, see `notes/triage.md`)
## Steps to reproduce
1. `python -m helpdesk reset`2. `python -m helpdesk ask "How many days do I have to return an unused item?" --seed 2`
## Actual result
"Thanks for asking. You can return an unused item within 30 days of delivery for a full refund of the item price. [1] I hope this helps." Source [1]: Returns policy, version 3: Return window. (trace tr-0001-1)
The trace lists two retrieved sections with the same score, 7.926: returns policy version 4 (in force from 2026-11-01) and version 3 (effective to 2026-10-31). `cited` is `returns-policy@3#return-window`. No tool was called.
## Expected result
- Must: say "45 days" and cite the returns policy, version 4.- Must not: say "30 days" or cite version 3 for a question asked on or after 1 November 2026.
## Reproduction rate
4 of 20 runs (seeds 2, 8, 11, 14), simulated (practice app); 30 of 100 with seeds 1-100. Case `cases/bugs.yaml` → `bug-002-return-window-version`. The same happens in French with seed 2.
## Evidence
- Conversation export: `evidence/bug-002-seed2.json` (replay after a reset: 1 of 1 same reply)- Trace: tr-0001-1
## Notes
Suspected layer (a guess): retrieval. The search returns the expired version 3 with the same score as version 4, so the reply can use either. Workaround for support agents: quote the returns policy, version 4.Exclure les secrets et les données personnelles
Section intitulée « Exclure les secrets et les données personnelles »Un rapport de bogue circule. Il passe dans un outil de suivi que beaucoup de personnes consultent, puis dans des canaux de discussion. Il arrive parfois chez une entreprise externe ou un agent de programmation. Tout ce qu’il contient peut fuiter. Un rapport contient donc uniquement des données de test.
Voici un rapport qu’une nouvelle testeuse pourrait rédiger à partir d’une vraie conversation au travail. Il est construit pour cette leçon : la personne, le courriel, la commande et la clé sont inventés.
Customer Maria Lopez (maria.lopez@example.com, order LK-90412) asked how longher refund takes to reach her card. The bot did not give the time.I ran it again in live mode with:HELPDESK_LIVE_KEY=sk-live-7f3a... python -m helpdesk ask "..." --liveDeux choses doivent disparaître. Le nom, le courriel et la commande de la cliente sont des données personnelles. Le rapport n’en a pas besoin, et elle n’a pas accepté de les partager. La clé est un secret : toute personne qui la lit peut utiliser le compte et dépenser son argent.
La version sûre montre le même constat avec un client de test, dans l’application d’exercice :
Test customer C-1001 asks "How long does a refund take to reach my card?"The reply gives no time for a card: "Refunds to a gift card appear at once. [1]"(simulated, practice app). Steps: python -m helpdesk reset, thenpython -m helpdesk ask "How long does a refund take to reach my card?" --seed 1Suivez quatre règles :
- Reproduisez avec un client de test. Si une vraie conversation a montré la défaillance, retrouvez-la avec les clients de test de l’application et rapportez ce résultat. Décrivez la forme du cas réel, par exemple « un numéro de commande d’un autre client », pas ses valeurs.
- Ne collez jamais une clé, un mot de passe ou un jeton. Nommez plutôt le paramètre : « mode réel, avec
HELPDESK_LIVE_KEYdéfinie ». L’application d’exercice n’écrit jamais la clé dans une trace ou un export. Toutefois, votre historique de terminal et vos captures d’écran peuvent la contenir. - Vérifiez vos pièces jointes. Ouvrez chaque export et chaque capture d’écran avant de les joindre. Un export d’un système réel peut contenir de vrais messages.
- Si un secret a fuité, signalez-le immédiatement. Ne vous contentez pas de le supprimer du rapport. Prévenez la personne responsable pour qu’elle remplace la clé.
La vérification finale : le test du lecteur externe
Section intitulée « La vérification finale : le test du lecteur externe »Comment savoir si votre rapport fonctionne? Donnez-le à un lecteur externe : une personne absente de votre session, avec seulement le rapport. L’image montre le test.
Description textuelle du diagramme
Votre rapport, et rien d’autre, va à un développeur absent de votre session. Il suit les étapes : réinitialisation, puis entrée exacte. S’il ne voit pas le résultat réel, trouvez ce qui manque : une version, la graine, le client, les mots exacts ou l’état des données. Ajoutez-le et réessayez.
S’il voit le résultat réel, la deuxième question est de savoir s’il peut juger la réussite à partir du résultat attendu seulement. Sinon, réécrivez le résultat attendu sous forme de règles « Doit » et « Ne doit pas », puis réessayez. Quand les deux réponses sont oui, le rapport est prêt pour le tri.
Si aucun collègue n’est disponible, jouez vous-même le rôle du lecteur externe. Fermez votre terminal et ouvrez-en un nouveau. Lisez seulement le rapport, pas vos notes. Suivez ses étapes exactement comme elles sont écrites. Esme l’a fait pour BUG-002 :
python -m helpdesk resetpython -m helpdesk ask "How many days do I have to return an unused item?" --seed 2The store is reset: 4 test customers, 8 orders, 8 reviews, no conversations.Thanks for asking. You can return an unused item within 30 days of delivery for a full refund of the item price. [1] I hope this helps.
Sources:[1] Returns policy, version 3: Return window (/policies/returns-policy/v3#return-window)
[conversation c-0001 | trace tr-0001-1 | seed 2]La réponse enfreint les deux règles du résultat attendu : elle indique 30 jours et cite la version 3. Le rapport réussit le test.
Quand utiliser le modèle complet et combien de temps prévoir
Section intitulée « Quand utiliser le modèle complet et combien de temps prévoir »Un bon rapport prend de 10 à 15 minutes une fois que vous avez la trousse de preuves. C’est moins qu’un échange avec le développeur : « Quelle version? Quelle graine? Qu’avez-vous tapé? » Utilisez le modèle complet pour chaque bogue qui quitte vos notes de session.
Gardez chaque section courte et rédigez un rapport par bogue. Si vous trouvez deux défaillances dans une réponse, rédigez deux rapports et reliez-les.
Erreur courante
Deux bogues dans un rapport
Symptôme : Esme pose la question sur les retours en français avec la graine 2. La réponse est en anglais et indique 30 jours, en citant la version 3 (simulation, application d’exercice). Son premier rapport couvre les deux problèmes. Tomás corrige la recherche, la réponse indique maintenant 45 jours et il ferme le rapport. La réponse est toujours en anglais.
Cause : un rapport contenait deux défaillances avec deux causes : la recherche (la politique expirée) et la langue de la réponse. La correction de l’une a fermé le rapport pour les deux.
Correction : rédigez un rapport par défaillance, chacun avec ses propres règles attendues, son taux et sa couche soupçonnée. Reliez-les : « Observé avec BUG-002 à la graine 2. » Chaque bogue est alors fermé seulement quand ses propres règles sont respectées.
Erreur courante
Le résultat attendu indique « la bonne réponse »
Symptôme : le rapport indique « Attendu : le robot doit donner le bon remboursement. » Tomás modifie la réponse et Esme rouvre le bogue, car le montant reste incorrect dans certains essais. Ils discutent du sens de « bon ».
Cause : le résultat attendu n’était pas vérifiable. Deux personnes le comprenaient différemment et personne ne pouvait le tester.
Correction : réécrivez-le avec des règles « Doit » et « Ne doit pas » et des valeurs réelles : « Doit : offrir 51,05 $ (64,00 moins 12,95 de frais d’expédition de retour). Ne doit pas : ajouter des frais ou un crédit absents d’une politique ou de la commande. » Vous et l’outil d’exécution pouvez alors déterminer clairement quand le bogue est corrigé.
À vous de jouer : réécrire les rapports en attente
Section intitulée « À vous de jouer : réécrire les rapports en attente »La liste dans practice-app/backlog/ contient quatre rapports faibles provenant d’agents de soutien. Vous avez réécrit BL-104 avec Esme. Réécrivez maintenant BL-101 vous-même, sous le nom BUG-003. C’est la tâche principale de ce module. Complétez ensuite l’ensemble des rapports du module. Prévoyez environ 45 minutes.
# BL-101: Order lookup broken!!
Reported by: support agent (chat shift)
Customer saw the wrong order in the chat. Very bad. Please fix ASAP.- Lisez BL-101. Notez ce qu’il dit et ce qu’il ne dit pas.
- Trouvez la défaillance avec les clients de test. Leurs commandes sont dans
practice-app/helpdesk/data/seed.json. Posez des questions comme un client de test : utilisez ses numéros de commande et ceux d’autres clients. - Quand vous voyez la défaillance, recueillez la trousse de preuves. Exportez-la dans
../workspace/bugs/evidence/. - Mesurez le taux. Ajoutez un cas
bug-003-...àworkspace/cases/bugs.yaml, exécutez-le et notez x essais sur y. - Copiez le modèle dans
../workspace/bugs/sous le nomBUG-003-suivi d’un nom court. Remplissez chaque section. Écrivez « Réécrit à partir du rapport en attente BL-101 » sous le titre. - Évaluez la gravité avec la matrice et ajoutez une ligne à
workspace/notes/triage.md. - Faites le test du lecteur externe : un nouveau terminal, seulement le rapport.
Rédigez ensuite les autres rapports de ce module de la même façon :
- BUG-004 à partir de BL-103 (« Le clavardage a planté. Erreur 500. »). Quelles entrées de Personas, cas limites et entrées hostiles pourraient faire planter un clavardage? Essayez-les dans l’application Web et dans le terminal.
- BUG-001, l’offre de remboursement, à partir de la trousse de preuves créée dans Recueillir les preuves.
- BUG-005, le refus de répondre à la question sur l’herbicide lors de votre première chasse aux bogues.
Défi facultatif : rédigez un rapport sur le constat de Tests métamorphiques. La question reformulée (« Quel est le délai pour retourner quelque chose que je n’ai pas utilisé? ») n’obtient jamais le délai de retour. Donnez les étapes pour les deux formulations, afin que le développeur voie une réussite et un échec. Joignez les deux exportations. Utilisez votre propre identifiant : les prochains rapports du cours, BUG-006 à BUG-008, arrivent au module 6.
Laissez BL-102 de côté pour l’instant. Ce type de défaillance est abordé dans Injection de requête et fuites de données.
Vérifiez vos rapports
Vérifiez chaque rapport avec cette liste. Chaque réponse doit être oui.
- Le titre indique-t-il ce qui échoue, où et à quelle fréquence (x essais sur y)?
- Les versions de l’application, de la requête et du modèle sont-elles présentes, avec la date de l’application, la graine et le client de test?
- Les étapes commencent-elles par
reset(réinitialiser) et donnent-elles l’entrée exacte, copiée? - Le résultat réel est-il reproduit mot pour mot, avec un identifiant de trace et les champs de trace qui l’expliquent?
- Chaque règle attendue est-elle un « Doit » ou « Ne doit pas » que l’outil d’exécution pourrait vérifier?
- Le taux repose-t-il sur au moins 20 essais (ou 5 sur 5 pour un bogue qui survient toujours), avec l’étiquette « simulation (application d’exercice) »?
- La couche soupçonnée est-elle présentée comme une hypothèse, avec une raison tirée de la trace?
- Y a-t-il une exportation dans
bugs/evidence, et peut-on la rejouer? - Tous les noms, commandes et comptes sont-ils des données de test, sans clé ni mot de passe nulle part?
- Un lecteur externe, ou vous dans un nouveau terminal, a-t-il vu la défaillance à partir du rapport seulement?
Pour BUG-003, examinez la trace de près. Elle montre deux appels d’outil. Lequel a échoué, et qu’est-ce que cela indique sur la couche?
Pour BUG-004, l’application Web montre une chose et le terminal en montre une autre. Mettez les deux dans le résultat réel. Sa réexécution indique turn 1: same error (tour 1 : même erreur) et 1 of 1 replies are the same (1 réponse sur 1 est identique). Une erreur qui se répète est reproduite, pas différente : l’exportation la reproduit donc bien.
L’instantané de l’espace de travail à la fin de ce module contient les cinq rapports d’Esme dans workspace/bugs/. Il contient aussi ses cas dans workspace/cases/bugs.yaml et ses notes de tri. Comparez-les aux vôtres après avoir terminé, pas avant.
Vérification des connaissances
Section intitulée « Vérification des connaissances »Vérifiez votre compréhension
Un rapport indique « Attendu : le robot doit donner au client le bon délai de retour. » Réécrivez-le en règles vérifiables pour l'application d'exercice à sa date, le 16 novembre 2026.
Afficher la réponse
- Doit : indiquer « 45 jours » et citer la politique de retour, version 4.
- Ne doit pas : indiquer « 30 jours » ni citer la politique de retour, version 3 (elle a pris fin le 31 octobre 2026).
Deux personnes vérifient ces règles de la même façon, et l’outil d’exécution le peut aussi : contains: 45 days et not_cites: returns-policy@3.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Le brouillon d'un collègue contient le nom et le courriel d'un vrai client, une capture du service de soutien en production et la clé de production dans les étapes. Que changez-vous, et suffit-il de supprimer la clé du rapport?
Afficher la réponse
Reproduisez la défaillance avec un client de test. Rédigez le rapport avec son identifiant, sa commande et son exportation. Décrivez seulement la forme du cas réel (« une commande d’un autre client »), et retirez le nom, le courriel et la capture. Remplacez la clé dans les étapes par le nom du paramètre, par exemple « mode production, avec HELPDESK_LIVE_KEY défini ». La supprimer ne suffit pas : la clé a déjà été partagée. Prévenez immédiatement son propriétaire pour qu’il la remplace.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Vérifiez votre compréhension
Vérification du module : qu'est-ce qui permet à un développeur absent de votre session de reproduire seul le bogue, et comment le vérifiez-vous?
Afficher la réponse
Les étapes commencent par reset et donnent l’entrée exacte, copiée, avec la graine et le client de test. Les versions (application, requête, modèle) et la date de l’application indiquent quelle version compilée utiliser. L’exportation rejoue la même réponse, et l’identifiant de trace montre ce qui s’est passé à l’intérieur. Le résultat attendu contient des règles « Doit » et « Ne doit pas ». Le développeur peut donc voir la défaillance et savoir quand elle est corrigée. Le taux de reproduction indique combien d’essais prévoir avant qu’elle apparaisse. Pour vérifier le rapport, donnez-le à un lecteur externe ou ouvrez un nouveau terminal. Lisez seulement le rapport et exécutez ses étapes. Si le résultat réel apparaît et que les règles déterminent la réussite ou l’échec, le rapport fonctionne.
Votre réponse contient-elle les points principaux de la nôtre ?
Connectez-vous et inscrivez-vous au cours pour enregistrer vos réponses. Chaque vérification compte pour le certificat.
Récapitulatif
- Un rapport de bogue est une recette pour une défaillance : une personne absente doit la provoquer et reconnaître sa correction.
- Chaque section du modèle répond à une question que le développeur vous poserait autrement.
- Rédigez le résultat attendu sous forme de règles « Doit » et « Ne doit pas ». L’outil d’exécution peut aussi vérifier une règle qu’une personne peut vérifier.
- Présentez la couche soupçonnée comme une hypothèse, avec la raison tirée de la trace.
- Données de test seulement : aucun vrai client, aucune clé, aucun mot de passe ni jeton. Reproduisez les cas réels avec des clients de test.
- Le test du lecteur externe valide le rapport : un nouveau terminal, seulement le rapport, la même défaillance.
Votre espace de travail contient maintenant cinq rapports dans workspace/bugs/, de BUG-001 à BUG-005. BUG-003 et BUG-004 sont réécrits à partir des rapports en attente. Leurs exportations sont dans workspace/bugs/evidence/, et un cas par bogue se trouve dans workspace/cases/bugs.yaml. Le fichier workspace/notes/triage.md contient les cinq. Ensuite, vous verrez ce qui arrive quand un agent de programmation, plutôt qu’une personne, lit votre rapport.
Leçon suivante : Ce dont un agent de programmation a besoin