Guide développement · 11 min

Revoir le code produit par un agent IA

Un agent de code peut modifier rapidement plusieurs fichiers, mais la vitesse ne prouve ni la correction ni la maintenance du résultat. La revue doit partir du comportement attendu et des risques de la modification.

Deux développeurs examinent ensemble du code et un plan de tests sur des écrans.
À retenir

Le contrôle minimal

Définissez l’objectif et les limites de la tâche, inspectez tous les fichiers modifiés, lancez les vérifications liées au changement, puis testez au moins un cas d’échec ou une valeur limite. Gardez une personne responsable de la décision d’intégration.

  • Périmètre précis
  • Diff complet et compréhensible
  • Tests liés au risque réel

Une revue en six étapes

  1. Illustration générée par IA

    1. Écrire le contrat de tâche

    Décrivez le comportement attendu, les entrées et sorties, les fichiers concernés et les contraintes de compatibilité. Mentionnez les secrets, données et commandes qui sont hors périmètre.

  2. Illustration générée par IA

    2. Isoler le changement

    Travaillez dans une branche ou un environnement séparé. Notez l’état initial afin de distinguer les modifications de l’agent de celles déjà présentes.

  3. Illustration éditoriale

    3. Lire le diff entier

    Recherchez les changements inattendus, dépendances ajoutées, permissions élargies, appels réseau, traitement des erreurs et données exposées dans les journaux. Demandez une explication pour chaque changement non nécessaire.

  4. Recherche documentaire avec atlas et livres dans une bibliothèque
    Illustration générée par IA

    4. Vérifier le comportement

    Exécutez les tests pertinents, puis essayez une entrée vide, invalide ou limite. Pour un bug, démontrez que le déclencheur échouait avant et réussit après la correction.

  5. Poste de développement avec écran de code
    Illustration générée par IA

    5. Contrôler la maintenance

    Vérifiez que les noms, commentaires, messages et interfaces restent cohérents avec le projet. Supprimez le code mort et les tests qui ne font que répéter l’implémentation.

  6. Studio de création avec appareil photo et tablette graphique
    Illustration générée par IA

    6. Intégrer avec responsabilité

    Résumez le changement, les vérifications effectuées et les risques restants. Une personne qualifiée valide la modification, surtout lorsqu’elle touche aux données, aux paiements ou aux droits d’accès.

Rejouer un scénario après application du correctif

Préparez un exemple qui reproduit le défaut ainsi qu’un cas voisin qui fonctionne déjà. Sur une branche de test, exécutez les deux avant et après le changement. Demandez au relecteur de vérifier le diff, les sorties des tests et les éléments ajoutés hors du périmètre initial. Si un test échoue, conservez sa sortie complète et rattachez-la à la version réellement exécutée.

Mettre la méthode à l’épreuve

Illustration générée par IA

Cas pratique

Confiez à un agent un correctif circonscrit dans un dépôt de test avec un test de régression qui échoue initialement.

Bureau en bois avec ordinateur portable et écran
Illustration générée par IA

Preuves à conserver

Gardez le ticket, les commandes, le diff, les tests exécutés et une revue des dépendances, secrets et fichiers hors périmètre.

Bibliothèque avec livres et carnet de recherche
Illustration générée par IA

Décider

Fusionnez seulement si la correction est comprise, testée et réversible par un mainteneur humain.

Atelier de vérification

Distinguer correction et faux succès

Utilisez une copie jetable d’un petit projet avec un défaut connu. Les commandes doivent fonctionner avant de demander une correction assistée.

Ordinateur portable et dossiers sur un bureau privé
Illustration générée par IA

Le test qui ne s’exécute pas

Entrée à préparer
Une commande affiche « terminé » mais ne découvre aucun test.
Résultat attendu
Le rapport indique le nombre de tests réellement exécutés et signale l’absence de couverture.
Si le contrôle échoue
Réparez la découverte des tests ; un code de sortie nul ne suffit pas.
Alignement d’une page sur un scanner de documents
Illustration générée par IA

La correction trop large

Entrée à préparer
Un défaut porte sur une valeur vide, mais le diff modifie aussi les permissions et une dépendance.
Résultat attendu
La correction reste justifiée fichier par fichier ; les changements étrangers sont retirés ou examinés séparément.
Si le contrôle échoue
Réduisez le diff avant validation et rejouez le cas initial.
Caméra et poste de montage dans un studio vidéo
Illustration générée par IA

Le comportement voisin

Entrée à préparer
Une correction accepte désormais la valeur vide mais casse une entrée valide précédemment acceptée.
Résultat attendu
Le cas initial et le cas voisin passent avec leurs assertions intactes.
Si le contrôle échoue
Ajoutez une attente indépendante sur le comportement voisin puis reprenez la correction.

Règle de décision. Acceptez un changement expliqué, limité et vérifié sur le défaut ainsi que sur le comportement voisin. Conservez le diff et les sorties utiles.

Ce qui mérite une attention particulière

Casque audio et repères temporels pour une transcription
Illustration générée par IA

Portée

Le diff correspond à la demande et n’altère pas des composants voisins.

Illustration générée par IA

Sécurité

Aucun secret, droit supplémentaire ou nouveau flux de données n’est introduit sans nécessité.

Recherche web avec ordinateur et documents annotés
Illustration générée par IA

Preuve

Les tests couvrent le comportement et les erreurs probables.

Conversation devant un téléphone et un ordinateur portables
Illustration générée par IA

Lisibilité

Un autre développeur peut expliquer et maintenir le résultat.

4 repères

Services utiles au développement et à la revue

Le catalogue réunit des assistants de code, outils locaux et plateformes d’automatisation. Comparez leur intégration, leur contrôle et leur qualité sur votre dépôt.

Comment cette sélection est-elle produite ?

Ces fiches sont reliées au sujet du guide dans notre catalogue éditorial. Leur présence ne constitue pas un classement ni une mesure de performance sur vos documents. Méthodologie.

Explorer toute la catégorie

Familles d’outils liées

Questions fréquentes

Les tests suffisent-ils ?

Non. Ils prouvent seulement les cas qu’ils couvrent. La revue doit aussi examiner la portée, la sécurité et la lisibilité.

Faut-il relire chaque fichier ?

Oui, au minimum chaque fichier modifié et les nouvelles dépendances. Un diff trop grand doit être découpé avant intégration.

Qui reste responsable ?

La personne ou l’équipe qui intègre et exploite le code, quelle que soit la manière dont il a été produit.

Les références ci-dessous approfondissent les concepts et contrôles évoqués. Les scénarios et grilles d’essai restent des propositions éditoriales ; une documentation fournisseur décrit son propre produit, pas un benchmark indépendant.

Sources officielles

Poursuivre avec un autre guide

Garder les preuves de cet essai

Rattachez ces éléments à une décision et à une condition de nouvel essai. Préparer la fiche de décision →