Interroger l’AI Reader sur un comportement précis
Formuler des questions sur des valeurs, bugs asynchrones et correctifs, ajouter le bon contexte et vérifier la réponse.
« Explique ce projet » donne une vue d’ensemble. Cela dit rarement pourquoi une branche précise a été exécutée ou si une modification est sûre. L’AI Reader est plus utile si vous ciblez un comportement et précisez ce qu’il faut vérifier.
Décrire le résultat observé et attendu
Une bonne première question décrit votre action, le résultat et ce que vous attendiez. Ajoutez le fichier ou la sélection si vous les connaissez. Sinon, décrivez le message ou l’action observée et demandez à l’AI Reader d’en trouver le point de départ.
Par exemple :
Ce rapport renvoie quatre lignes avec
REPORT_LIMIT=4, alors que le fichier de configuration en prévoit six. Suis la limite de l’entrée à la sortie. Montre quelle source l’emporte et ce qui se passe si la valeur d’environnement est vide.
Cette question a une fin claire : quelle source est choisie, où elle est validée et où elle est utilisée. Elle suggère aussi un petit test à écrire. Le parcours de configuration montre ce que couvre une réponse complète.
Choisir le contexte de départ
| Contexte | Utile pour | À vérifier vous-même |
|---|---|---|
| Sélection | Expliquer une expression ou une branche | Hypothèses de l’appelant, conditions environnantes |
| Fichier | Comportement réparti sur plusieurs méthodes | Imports et état externe |
| Dossier | Sous-système connu, point d’entrée inconnu | Fichiers qui participent réellement |
| Comparaison Git | Examiner des commits précis | Sens de base et head, contexte antérieur |
Le contenu ajouté n’est qu’un point de départ. L’AI Reader peut ouvrir d’autres fichiers du projet autorisé pour suivre les dépendances ; une requête peut donc inclure plus que le fichier ajouté. Si cela compte pour du code confidentiel, lisez d’abord ce qui est envoyé.
Exemples de questions
Pour un bug d’interface asynchrone :
Sélectionner A puis B laisse parfois le contenu de A à l’écran. Suis les deux requêtes à travers chaque await. Liste les écritures dans success, catch et finally, et montre ce qui empêche une ancienne requête de modifier la vue actuelle.
Le tutoriel sur les courses asynchrones JavaScript reproduit cette séquence et utilise un compteur de requêtes pour protéger le texte, l’erreur et l’état de chargement. Téléchargez l’exemple pour exécuter les tests fournis.
Pour la revue d’un correctif :
Examine cette comparaison pour les changements d’invalidation du cache. Pour chaque régression possible, donne l’emplacement modifié, un ordre d’événements réellement possible, ce que verrait l’utilisateur et un test distinguant ancien et nouveau comportement. Liste séparément les problèmes existants.
Pour une question d’architecture :
Quel composant possède ce cache, qui peut l’invalider et quels appelants partagent une entrée ? Cite les constructeurs et le code qui le modifie. Signale tout ce qui dépend de la configuration à l’exécution.
Chaque question précise ce qu’une bonne réponse doit inclure : un ordre d’événements, un test distinguant deux versions ou le code qui crée et modifie le cache.
Vérifier une affirmation avant d’aller plus loin
Ouvrez une référence importante dans l’aperçu rapide du code, puis le fichier entier si nécessaire. Vérifiez que la condition citée vaut pour votre entrée et qu’un autre appelant, une surcharge ou un chemin d’erreur ne change pas la réponse.
Si la réponse laisse un manque, posez une question ciblée :
Tu as trouvé deux implémentations. Où cette requête en choisit-elle une ? Si le code seul ne permet pas de le savoir, quelle valeur d’exécution faut-il ?
L’AI Reader ne peut pas exécuter les tests du projet : un test proposé n’a donc pas encore été lancé. Exécutez-le vous-même et collez le résultat dans la discussion.
Approfondissements et questions annexes
Si la question suivante approfondit la même trace, restez dans la discussion. Pour explorer une autre direction, utilisez Créer une nouvelle discussion à partir d’ici sur une réponse terminée. Cela crée une discussion indépendante avec le contexte jusqu’à cette réponse et laisse l’originale intacte.
L’AI Reader ne modifie les fichiers qu’après activation d’Autoriser les modifications pour une exécution. Les suivantes et les discussions dérivées repartent en lecture seule. Les comparaisons Git restent toujours en lecture seule. Après une modification, lisez le diff et lancez les vérifications concernées.