AI CodeOps

Agent Reviewer

L'agent Reviewer vérifie l'exactitude, les cas limites et la maintenabilité des changements proposés, et liste des correctifs concrets. Il intervient dans huit workflows intégrés.

L'agent Reviewer est la seconde paire d'yeux, critique. Il lit le changement proposé et y cherche des problèmes d'exactitude, de clarté, de cas limites et de maintenabilité. Il liste des problèmes concrets, avec un correctif concret pour chacun.

Où il intervient

WorkflowÉtape
Plan, Build, Review & TestReview
Parallel ReviewCorrectness review
UI ImplementationCode review
Architecture DebateCritic review
Swarm InspectionReviewer slice
Release ReadinessCorrectness review
Data MigrationFinal review
Quality-Gated ChangeReview

Dans Architecture Debate, il joue le rôle du critique : il met à l'épreuve les deux conceptions concurrentes de l'Architect avant la synthèse finale.

Le moment où son étape s'exécute dépend du workflow :

  • Après l'écriture du code. Dans Plan, Build, Review & Test, UI Implementation, Data Migration et Quality-Gated Change, son étape suit celle qui implémente le changement. Il attend donc que le code soit écrit et que les tests du projet aient été exécutés, puis relit ce changement.
  • Avant la passe de code. Parallel Review, Swarm Inspection et Release Readiness n'ont pas d'étape d'implémentation. Toutes leurs étapes s'exécutent avant qu'aucun code ne soit écrit, et le Reviewer travaille à partir de la tâche et du code déjà présent dans le dépôt.
  • Aucun code. Architecture Debate se termine par ses documents.

Entrées

  • La tâche de la session et un instantané en lecture seule des fichiers pertinents du dépôt du projet.
  • Les étapes précédentes : en général un plan et la description du changement par le Builder.
  • Lorsqu'il s'exécute après l'écriture du code : le changement sous forme de diff, coupé pour tenir, avec la coupure signalée lorsqu'il est long, et le résultat de test enregistré. Il a pour consigne de citer les fichiers qu'il a lus.
  • Les outils des serveurs MCP connectés, si la politique de votre espace de travail les autorise.

Sorties

L'étape du Reviewer renvoie une liste de problèmes avec leurs correctifs, sous forme de texte. Elle influe sur le reste de la session de deux façons :

  • Les étapes suivantes la lisent. Lorsqu'il s'exécute avant la passe de code, la passe de code la lit aussi et peut en tenir compte. Lorsqu'il s'exécute après l'écriture du code, rien dans la session ne réécrit le changement à partir de cette liste : traitez ses points avec un prompt de suivi.
  • Après les étapes du workflow, la session exécute une passe des constats qui relit le diff réel et enregistre des constats structurés, chacun avec un titre, une gravité, une catégorie, une recommandation et, le cas échéant, le fichier. L'analyse du Reviewer est fournie à cette passe comme contexte. Lorsqu'aucun Security Auditor ne s'est exécuté dans la session, les constats sont attribués au Reviewer.

Ces constats apparaissent sur la session et sur les pages qualité de l'espace de travail, et la barrière de livraison les vérifie avant qu'un changement puisse être livré. Si la revue des constats ne parvient pas à s'exécuter, la barrière retient le changement au lieu de prendre ce silence pour une réussite.

Avec le niveau Auto, les étapes du Reviewer vont d'abord au niveau Premium.

Exemple d'exécution

Exemple illustratif, pas une session enregistrée. Dans Quality-Gated Change, la session écrit un nouvel export CSV des factures et les tests du projet s'exécutent dessus. Le Reviewer lit ensuite le diff et relève trois points dans le fichier d'export : les montants sont formatés selon la locale du serveur, si bien qu'un séparateur décimal en virgule casse le fichier ; les noms des clients ne sont pas échappés, si bien qu'un nom contenant une virgule décale toutes les colonnes ; et l'export charge toutes les factures en mémoire. Il propose un format numérique fixe, des guillemets corrects et une réponse en streaming. La passe des constats relit ensuite le même diff avec ces remarques comme contexte, et une session de suivi apporte les corrections.

Limites

  • Une fois le code écrit, il lit le diff, et un diff long est coupé pour tenir, avec la coupure signalée. La passe des constats lit aussi le diff : lisez ses constats, pas seulement l'étape du Reviewer.
  • Son étape ne modifie pas le code. Un correctif qu'il propose après l'écriture du code nécessite une session de suivi, ou le bouton Fix sur un constat.
  • Il n'exécute pas le code. Le comportement est vérifié par les tests du projet à l'étape verify (vérification), et le Tester lit le résultat.
  • Il peut se tromper dans les deux sens : il peut manquer un vrai bug comme signaler un faux problème. Les constats peuvent être triés sur la session.

Questions fréquentes

L'agent Reviewer voit-il le diff final ?

Dans quatre de ses huit workflows, oui. Lorsque son étape suit celle qui implémente le changement, il s'exécute une fois le code écrit et testé, et reçoit le diff et le résultat de test enregistré. La passe des constats de la session relit ensuite le même diff et enregistre les constats qui conditionnent le passage du changement.

Les constats de revue peuvent-ils bloquer une fusion ?

Oui. Les constats issus de la revue du diff sont enregistrés sur la session, et la barrière de livraison vérifie cette revue avant que le changement puisse être livré.