Mode débogage
Le mode débogage vous aide à identifier les causes racines et à corriger les bugs coriaces, difficiles à reproduire ou à comprendre. Au lieu d’écrire immédiatement du code, l’agent formule des hypothèses, ajoute des instructions de journalisation et exploite les informations d’exécution pour cerner précisément le problème avant d’apporter un correctif ciblé.
Quand utiliser le mode débogage
Le mode débogage est particulièrement efficace pour :
- Les bugs que vous pouvez reproduire sans en trouver la cause : lorsque vous savez que quelque chose ne va pas, mais que la cause n'est pas évidente à la lecture du code
- Les conditions de concurrence et les problèmes de synchronisation : problèmes qui dépendent de l'ordre d'exécution ou du comportement asynchrone
- Les problèmes de performances et les fuites de mémoire : issues nécessitant un profilage à l'exécution pour être comprises
- Les régressions, lorsqu'une fonctionnalité fonctionnait auparavant : lorsque vous devez déterminer ce qui a changé
Lorsque les interactions standard avec l'Agent peinent à résoudre un bug, le mode débogage propose une approche différente, fondée sur des données d’exécution plutôt que sur des correctifs hypothétiques.
Fonctionnement
-
Explorer et formuler des hypothèses : L’agent explore les fichiers pertinents, établit le contexte et génère plusieurs hypothèses sur les causes racines possibles.
-
Ajouter de l’instrumentation : L’agent ajoute des instructions de journalisation qui envoient des données à un serveur de débogage local exécuté dans une extension Cursor.
-
Reproduire le bug : Debug Mode vous demande de reproduire le bug et vous indique les étapes à suivre. Vous restez ainsi impliqué, et l’agent peut capturer le comportement réel à l’exécution.
-
Analyser les journaux : Après la reproduction, l’agent examine les journaux collectés afin d’identifier la véritable cause racine à partir des données d’exécution.
-
Apporter un correctif ciblé : L’agent apporte un correctif ciblé qui traite directement la cause racine, souvent en quelques lignes de code seulement.
-
Vérifier et nettoyer : Vous pouvez réexécuter les étapes de reproduction pour vérifier le correctif. Une fois celui-ci confirmé, l’agent supprime toute l’instrumentation.
Conseils pour le mode débogage
- Fournissez un contexte détaillé : Plus vous décrivez le bug et la manière de le reproduire, plus l’instrumentation de l’agent sera efficace. Incluez les messages d’erreur, les traces de pile et les étapes précises.
- Suivez scrupuleusement les étapes de reproduction : Exécutez les étapes fournies par l’agent afin que les journaux capturent le problème réel.
- Reproduisez le bug plusieurs fois si nécessaire : Cela peut aider l’agent à identifier des problèmes complexes, comme les conditions de concurrence.
- Distinguez clairement le comportement attendu du comportement réel : Aidez l’agent à comprendre ce qui devrait se produire et ce qui se produit réellement.
Changer de mode
- Utilisez le menu de sélection du mode dans Agent
- Appuyez sur Shift+Tab pour basculer rapidement