iCode Agent · Guide · Workflow

Traquez un bug.

La partie difficile d’un bug n’est généralement pas la correction — c’est de trouver la cause. iCode Agent suit les indices dans le code et vous dit ce qu’il a trouvé, au lieu de deviner un correctif.

La tâche

Décrivez le symptôme et, si possible, comment le reproduire :

Users report that saving a duplicate name overwrites the original.
Reproduce it, find the cause, then fix it.

Une reproduction est l’entrée la plus précieuse que vous puissiez fournir. Sans elle, demandez d’abord à l’agent d’en trouver ou d’en écrire une — un bug que vous ne pouvez pas déclencher est un bug dont vous ne pouvez pas confirmer la correction.

Ce qui se passe

  1. Reproduire. Il exécute la commande ou le test en échec et lit la sortie réelle — une trace de pile, une erreur, une valeur incorrecte.
  2. Suivre les indices. Il remonte du symptôme vers la cause : le code appelant, les données, l’état. Un échec est une information, et il continue de tirer le fil.
  3. Nommer la cause. Il explique ce qui ne va pas et pourquoi, avec le code qui le montre — pas seulement où corriger.
  4. Corriger et vérifier. Il effectue la plus petite modification qui s’attaque à la cause et relance la vérification qui a échoué.

Demandez avant d’accepter la correction

Un correctif qui fait disparaître un symptôme n’est pas un bug corrigé. Demandez le raisonnement, et si la cause est traitée :

Reproduce the failure in tests, explain the root cause, then fix it.
Don't change the test to make it pass — the test is correct.
Show me every place this same bug could occur.

Cette dernière ligne compte : une bonne chasse au bug demande si le bug est un cas particulier d’un schéma plus général, et non un incident isolé.

Quand la réponse est « je n’arrive pas à le reproduire »

C’est un résultat utile, pas un échec. L’agent dira ce qu’il a essayé et ce qu’il a observé. À partir de là, vous pouvez préciser l’environnement, fournir une entrée qui déclenche le bug ou demander une instrumentation pour journaliser l’état à l’endroit où vous l’attendez.