Une relecture qui commente tout finit par être ignorée
Une bonne relecture de pull request laisse trois commentaires, pas trente. Si un relecteur automatisé signale chaque écart, l'équipe les saute, et le commentaire important se perd parmi les autres.
Pour décider quels cas méritent un commentaire, il faut les conventions de code que votre équipe impose, celles qu'elle tolère, et les parties du code où un petit changement peut encore compter. Le contexte compte aussi. Un test manquant pour un endpoint expérimental et un test manquant sur le chemin de facturation sont le même type de problème, avec un poids très différent.
L'agent laisse des commentaires qui énoncent un point puis s'arrêtent. Il n'approuve pas, ne fusionne pas et ne bloque pas les relectures. Un humain déjà nommé mène la relecture.
Comment l'agent est construit dans Agent Studio
Les prompt skills énoncent les critères que votre équipe applique en relecture : les règles que vous imposez, pas un guide de style, et les conventions que vous avez délibérément décidé de ne pas policer.
Un second prompt skill met en avant les zones sensibles du code, comme la facturation, l'authentification et la migration de données. Le poids varie selon l'endroit où un changement est fait, à cause de ces zones.
Le prompt système plafonne le nombre de commentaires et exige qu'ils soient classés. L'agent doit choisir ce qui compte plutôt que de produire une liste exhaustive.
Un commentaire doit énoncer la conséquence, pas seulement l'écart. S'il dit seulement qu'une convention a pu être manquée, c'est du bruit. S'il dit que ce chemin peut désormais être utilisé deux fois, c'est une relecture.
Un déclencheur Webhook reçoit les événements de pull request. Le nœud GitHub transmet le diff, le ticket lié et l'historique récent des fichiers au nœud Agent Chat.
Le nœud GitHub republie les commentaires comme commentaires de relecture attribués à l'agent, pour qu'ils ne soient pas traités comme venant d'un collègue.
L'agent ne fusionne ni n'approuve aucun changement, et n'en bloque aucun. Lorsqu'un commentaire est publié, tout item qui touche une zone sensible est envoyé à un relecteur désigné.
De quoi cet agent est constitué
- Prompt skills : ce que votre équipe impose et ce qu'elle a décidé de ne pas policer.
- Prompt skills : les zones sensibles où un petit changement porte du poids.
- System prompt : un jeu plafonné et classé de commentaires plutôt qu'un résultat exhaustif.
- System prompt : chaque commentaire énonce la conséquence, pas l'écart.
- Webhook (Triggers) avec GitHub (Integration) : le diff, le ticket lié, et l'historique récent des fichiers.
- Agent Chat (Util) : commentaires publiés attribués à l'agent. Pas de fusion, pas d'approbation, pas de blocage.
- Quand un ActionFlow suffit : Si vous n'avez besoin que de vérifier que des tests, un ticket lié et une description existent, construisez le flux de travail. Ce contrôle retire la friction de relecture la plus courante.
Questions fréquentes
Newsletter
Recevoir les mises à jour produit
Nouveaux nœuds, agents et notes produit. Nous n'envoyons un e-mail que lorsqu'il vaut la peine de l'ouvrir.