Guide

Programmer avec l’IA : d’une consigne claire à une modification vérifiée

Donnez à un assistant de codage un contexte de référentiel utile, vérifiez le comportement demandé et laissez une modification qu'un autre développeur peut examiner.

Article traduit. Lire l'article original

Une tâche de codage d’IA utile se termine par un changement que vous comprenez et pouvez vérifier. Partez d'un comportement, fournissez suffisamment de contexte de projet pour l'expliquer et examinez la différence résultante ainsi que les vérifications pertinentes. Ce flux de travail s'applique que vous utilisiez un assistant éditeur, un agent de terminal ou un environnement de codage cloud préparé.

Décrire le comportement avant les fichiers

Pour un bug, enregistrez l'entrée ou l'action qui le déclenche, ce qui se passe et ce qui devrait se produire à la place. Pour une fonctionnalité, donnez un exemple de comportement réussi et un cas limite important. Incluez la commande ou l’écran existant utilisé pour observer le résultat.

Par exemple : "Lorsque le champ de recherche ne contient que des espaces, la page doit afficher la liste d'articles par défaut. Elle ne renvoie actuellement aucun résultat. Préserver les recherches contenant du texte réel." C'est plus utile que « Fixer la recherche » et cela donne à la fois à l'assistant et au réviseur une cible concrète.

Préparer un projet que l'assistant peut comprendre

Utilisez une branche vierge ou une autre copie de travail réversible. Assurez-vous de savoir comment installer les dépendances, démarrer l'application et exécuter les vérifications pertinentes. Enregistrez tous les échecs existants avant de demander à l’assistant de modifier le code. Sinon, vous risquez de confondre un échec sans rapport avec une régression ou un succès préexistant comme une preuve du nouveau comportement.

Dirigez l'assistant vers les instructions du projet, les fichiers de dépendances et le module le plus proche du problème. Évitez de coller l'intégralité du référentiel lorsqu'une brève explication et quelques fichiers pertinents suffiront. Conservez les informations d’identification et les données client non liées hors du matériel de tâche.

Documentation officielle de Cursor organise les flux de travail autour de la compréhension du code, de la planification des modifications, de la correction des bogues et de la révision des différences. Démarrage rapide officiel d’OpenAI décrit les points d'entrée de l'éditeur et du terminal local et les environnements cloud préparés pour Codex. Les étapes ci-dessous constituent une méthode de révision éditoriale plutôt qu'un rapport de performances mesurées.

Demander un changement limité

Indiquer les critères d'acceptation et les éventuelles contraintes réelles, comme conserver une API publique ou éviter une nouvelle dépendance. Demandez à l'assistant d'identifier le chemin pertinent dans le code et de mettre en œuvre le plus petit correctif cohérent. Si la tâche touche un système externe, définissez exactement quelles actions font partie de la demande.

Pour un domaine inconnu, demandez d’abord une brève explication du flux existant avec des références de fichiers. Vérifiez cette explication avant d’autoriser une réécriture importante. Si l'assistant constate que le comportement demandé est en conflit avec les règles actuelles, résolvez ce conflit explicitement au lieu de le cacher derrière un changement de code.

Vérifier le résultat à travers l'exemple original

Répétez la reproduction originale après le changement. Vérifiez le comportement attendu et le cas limite pertinent. Exécutez les commandes de tests, lint ou build existantes qui couvrent la zone affectée. Une commande réussie est une preuve de ce qu’elle a vérifié ; cela n'établit pas que chaque partie de l'application fonctionne.

Si une nouvelle couverture est nécessaire, faites en sorte que le test observe le comportement réel. Un test qui se contente de reformuler l'implémentation de l'assistant constitue une protection faible. Pour le travail d'interface, ouvrez l'écran modifié et inspectez-le à une taille de bureau et mobile appropriée.

Examiner la différence en tant que tâche distincte

Lisez chaque fichier modifié. Recherchez un formatage sans rapport, une gestion des erreurs manquante, des dépendances inattendues et un comportement en dehors du brief d'origine. Portez une attention particulière aux opérations de base de données, aux autorisations de compte et aux tâches en arrière-plan, car leurs effets peuvent persister au-delà d'un rechargement de page.

Terminez par un bref transfert : le problème, le nouveau comportement, les vérifications effectuées et tout ce qui n'est pas encore résolu. Gardez la modification suffisamment petite pour qu'un autre développeur puisse l'examiner sans reconstruire l'intégralité de la conversation. Le résumé final de l'assistant doit vous orienter vers des preuves ; la différence examinée et le comportement observé sont ce qui rend le résultat utile.

Source originaleSource officielle
Annuaire des outilsCursorFonctionnalités, accès et forfaits