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
- 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.
- 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.
- Nommer la cause. Il explique ce qui ne va pas et pourquoi, avec le code qui le montre — pas seulement où corriger.
- 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.