Passer au contenu principal
Devin Review regroupe les modifications connexes d’une pull request, les explique en regard du diff et signale les bugs potentiels ainsi que les problèmes de sécurité. Vous pouvez demander la revue d’une seule PR sans activer les revues automatiques pour votre équipe.

Effectuer la revue d’une pull request

Déclencher une revue depuis un commentaire sur les PR

  1. Sur une pull request GitHub ou une demande de fusion GitLab ouverte, publiez un nouveau commentaire : /devin review.
  2. Suivez le lien figurant dans la réponse de Devin. Lisez la vue d’ensemble, puis ouvrez un groupe de modifications liées pour comprendre comment elles s’articulent.
  3. Dans le panneau latéral d’analyse ou la vue Bugs, sélectionnez un constat et confrontez-le au code. Si vous avez besoin de plus de contexte, citez-le dans la conversation. Vous pouvez corriger le code vous-même ou demander à Devin d’effectuer une modification.
La commande fonctionne aussi bien dans les commentaires de conversation que dans les commentaires en ligne. Associez votre compte Git à Devin et assurez-vous que votre organisation Devin a accès au repository. /devin review lance une analyse. Un commentaire tel que /devin fix the failing test demande en revanche à une session Devin d’effectuer un travail sur la PR. Consultez Démarrer Devin depuis un commentaire de PR pour GitHub et Démarrer Devin depuis un commentaire de MR pour GitLab.

Autres façons d’ouvrir une revue

  • Depuis Devin : ouvrez Devin Review et choisissez une PR dont vous êtes l’auteur, qui vous a été attribuée ou pour laquelle votre revue a été demandée. Vous pouvez également coller l’URL d’une PR dans le champ de lien de PR, y compris pour GitHub Enterprise ou Azure DevOps. Pour une PR GitHub.com, vous pouvez omettre https:// ou utiliser owner/repo#123.
  • Depuis GitHub.com : remplacez github.com par devinreview.com dans l’URL de la PR. Vous pouvez consulter une PR publique sans compte Devin. Pour une PR privée, connectez-vous avec un compte qui y a accès.
  • Depuis une session Devin : sélectionnez Analyze sur la carte de la PR. Si la carte propose à la fois Analyze once et Analyze, choisissez Analyze once pour une revue ponctuelle. Analyze active en outre les revues lors des prochains pushs sur cette PR.
Pour les autres hôtes Git, consultez la section Fournisseurs Git pris en charge. Dans la liste Review, chaque PR ouverte affiche son état actuel, par exemple CI failing, Changes requested, Review required ou Ready to merge. Sur les écrans larges (1280px et plus), la sélection d’une PR l’ouvre dans un panneau à côté de la liste, et la sélection d’une autre PR la remplace. Le panneau se ferme lorsque vous rechargez ou quittez la page. Pour ouvrir plutôt la PR dans un nouvel onglet du navigateur, cliquez dessus en maintenant la touche Cmd ou Ctrl enfoncée. Dans la liste, appuyez sur j ou k pour sélectionner la PR suivante ou précédente, sur o ou l pour l’ouvrir dans le panneau, ou sur Enter pour ouvrir sa page de revue complète. Lorsque la PR le permet, a l’approuve et passe à la PR suivante, tandis que m la fusionne ou l’ajoute à la file d’attente, puis passe à la suivante. Ces raccourcis propres à la liste diffèrent des raccourcis de la page de PR.

Devin Review en action

Lire une revue

Commencez par la vue d’ensemble pour comprendre quel comportement la PR modifie. Dans Guide view, lisez le diff par groupe : un groupe peut rassembler des modifications connexes provenant de plusieurs fichiers. Lorsque Devin détecte du code copié ou déplacé, il affiche le déplacement plutôt qu’une suppression suivie d’un ajout identique. Les constats du Détecteur de bogues apparaissent dans le Panneau latéral d’analyse ou dans la vue Bugs. Posez vos questions sur la PR dans la conversation et obtenez des réponses enrichies du contexte pertinent issu du reste de la base de code ; vous pouvez également interroger Devin directement depuis n’importe quel commentaire, bug ou indicateur de la vue diff. Sur mobile, la revue s’ouvre sur Changes. Passez à Bugs pour consulter les bugs, les indicateurs et les constats de sécurité, ou utilisez Description, Discussion et Commits pour les autres détails de la PR. Lorsqu’un lien vers un commentaire ou une revue GitHub s’ouvre dans Devin Review, la page défile jusqu’à l’élément ciblé et le met en évidence. Cela fonctionne également dans l’onglet revue d’une session Devin, où un lien GitHub vers un fichier du diff de la PR ouvre directement ce fichier. Lorsque des commits sont poussés après la dernière revue et qu’aucune règle ne prévoit leur revue, une bannière Devin hasn’t analyzed the latest changes indique le dernier commit examiné et le nombre de nouveaux commits. Analyze latest lance une revue supplémentaire du commit actuel sans activer l’auto-review ; Analyze automatically l’active pour cette pull request, pour toutes les pull requests que vous ouvrez ou, si vous pouvez gérer les paramètres de revue du repository, pour toutes les pull requests du repository. Dans l’onglet revue d’une session Devin, See changes affiche ce qui a été poussé depuis la dernière revue. Lorsqu’une revue plus récente est disponible, New commit affiche un commit poussé pendant que la revue était ouverte, View latest commit affiche un diff plus récent pour un commit déjà connu de Review, et New analysis met à jour l’analyse sans changer le commit affiché.
  • Marquez les fichiers comme Viewed pour suivre votre progression, ou marquez tous les fichiers comme vus ou non vus depuis la liste des fichiers.
  • Développez les lignes de contexte autour d’une modification, ou utilisez Expand all lines dans l’en-tête d’un fichier pour afficher le fichier entier et Collapse expanded lines pour le replier. Pour un fichier Markdown, basculez entre le diff rendu et la source.
  • Sélectionnez des lignes du nouveau côté d’un diff pour utiliser Add to Chat, ou choisissez Suggest change pour ouvrir sur ces lignes un commentaire de revue prérempli avec un bloc de suggestion contenant leur texte actuel.
  • Masquez les modifications qui ne portent que sur les espaces pour vous concentrer sur les changements de fond.
  • Le nombre de lignes affiché dans l’en-tête de la PR et dans la liste Review exclut par défaut les tests et le code généré. Survolez un nombre pour afficher sa répartition par catégorie, puis choisissez Relevant, Both ou Full pour changer le décompte affiché. Un clic sur le nombre fait alterner ces trois affichages. Votre choix s’applique aux deux emplacements.
  • Appuyez sur Cmd+F ou Ctrl+F pour effectuer une recherche dans la revue. L’icône de filtre du champ de recherche propose les options Match case, Changed lines only et Skip collapsed files. Par défaut, la recherche ignore le contenu des fichiers réduits, qu’ils soient marqués comme vus ou non. Les noms de fichiers et de dossiers restent toutefois pris en compte.
  • Utilisez Analysis history dans le menu d’actions de l’en-tête pour consulter une analyse antérieure. Dans Select commits to view, vous pouvez inverser l’ordre des commits examinés. Sur GitHub, le sélecteur affiche également les approbations et les demandes de modification associées à ces commits. Un lien épinglé à un commit plus ancien n’affiche pas automatiquement les résultats les plus récents ; utilisez Switch to latest ou Run analysis on latest lorsque ces options sont disponibles.
  • Consultez la vue Checks pour connaître le statut de la CI. Chez les fournisseurs compatibles, gérez les relecteurs, les libellés et les responsables sans quitter Review.
  • Le menu des paramètres du diff propose une option Layout : File tree view affiche les diffs non regroupés avec l’arborescence des fichiers, tandis que Guide view regroupe les modifications liées et les accompagne d’explications.
Les onglets et contrôles disponibles dépendent du fournisseur et de vos droits d’accès.

Fichiers générés et limites de taille du diff

Les fichiers marqués linguist-generated dans le fichier .gitattributes à la racine de votre dépôt Git ne sont pas pris en compte dans la limite de taille du diff de Devin Review. La revue affiche leur nombre de lignes ajoutées et supprimées, sans analyser les modifications apportées à ces fichiers. Devin Review lit le fichier .gitattributes à partir du commit de tête de la PR : une règle ajoutée dans une PR s’applique donc à la revue de cette même PR. Les relecteurs personnalisés et l’Autoapprover ne tiennent compte que des règles déjà présentes sur la base de fusion (l’ancêtre commun utilisé pour le diff de la PR) ; une PR ne peut donc pas en exclure ses propres fichiers. Par exemple, pour marquer comme générés les fichiers situés sous src/generated/, ajoutez cette règle au fichier .gitattributes à la racine :
Cette exclusion ne modifie pas les limites de diff propres à votre fournisseur Git. Par exemple, si GitHub ne renvoie pas le diff parce qu’il est trop volumineux, Devin Review ne peut pas appliquer l’exclusion.

Bug Catcher

Le Bug Catcher analyse votre pull request (PR) afin de détecter d’éventuels problèmes. Les éléments détectés comprennent des Bugs, des indicateurs et des éléments de Sécurité. Les relecteurs personnalisés en version bêta disposent de leurs propres éléments détectés, qui leur sont attribués. Si une session Devin a ouvert la PR pour corriger un constat d’analyse de code, la revue intégrée comporte un onglet distinct Finding ou Findings dédié à ces constats liés. Cet onglet apparaît dans le volet Review ou Inbox, ainsi que dans l’onglet PR de la session, à condition que vous ayez accès aux constats.

Bugs

Devin signale les erreurs probables comme des bugs. Examinez d’abord les bugs graves, signalés par une icône de bug rouge. Les bugs moins graves sont signalés par une icône d’avertissement orange. Lorsque la section Learn more est disponible, développez-la pour consulter le scénario de défaillance et le correctif recommandé. Le bouton de copie copie l’emplacement, l’explication et, le cas échéant, la modification suggérée.

Indicateurs

Un indicateur Examiner soulève une question sur le code : vérifiez les lignes signalées avant de décider si un correctif s’impose. Un indicateur Informatif explique une modification sans exiger de correctif de votre part.

Sécurité

Devin Review détecte les vulnérabilités de sécurité et les affiche aux côtés des autres constats. L’analyse de sécurité fait partie d’une revue complète ; utilisez les paramètres de publication pour déterminer si les constats de sécurité sont publiés en tant que commentaires sur les PR. Une analyse limitée au diff, par exemple lorsque la revue automatique est suspendue en raison d’une limite de dépenses, ne constitue pas une revue de sécurité complète. Le scanner vérifie les catégories de vulnérabilités suivantes :
  • Injection (SQL, XSS, commande, template)
  • Failles d’authentification (contrôle d’accès manquant ou défaillant, élévation de privilèges, contournement de l’authentification)
  • Exposition de secrets (clés codées en dur, tokens dans les logs, identifiants dans le code source)
  • SSRF et traversée de répertoires
  • Désérialisation non sécurisée, pollution de prototype
  • Absence de validation des entrées sur des données non fiables
  • Cryptographie faible (algorithmes, gestion des clés)
  • Sécurité du transport et des cookies (absence d’obligation d’utiliser HTTPS, CORS permissif, attributs de cookie non sécurisés)
  • Paramètres par défaut non sécurisés ou erreurs de configuration introduits par la PR
Les résultats sont affichés avec deux niveaux de gravité :
  • Critique — Vulnérabilités détectées avec un degré de confiance élevé, à corriger avant la fusion
  • Avertissement — Faiblesses de sécurité potentielles qui méritent d’être examinées
Chaque résultat comprend une description du problème, une recommandation pour le corriger et, le cas échéant, un identifiant CWE classant le type de vulnérabilité. L’analyse de sécurité tient également compte de toutes les instructions liées à la sécurité dans vos fichiers d’instructions — par exemple, vous pouvez ajouter des politiques de sécurité, des zones sensibles ou des modèles de menace à votre REVIEW.md afin d’orienter les éléments recherchés par le scanner. Lorsque le contexte du modèle de sécurité du dépôt est disponible, la revue intégrée et les réviseurs personnalisés marqués Security-related lisent également les fichiers SECURITY_MODEL.md et THREAT_MODEL.md, ainsi que les sections de SECURITY.md consacrées au modèle de menace ou de sécurité, situés à la racine du dépôt.

Que se passe-t-il lors du prochain push ?

Lorsque Devin effectue la revue d’un nouveau push sur une PR qu’il a déjà examinée, il recherche généralement les bugs introduits ou affectés par les modifications apportées depuis la dernière revue. Il reprend les constats précédents et vérifie si les nouveaux commits les ont corrigés. Si les nouveaux commits modifient en profondeur le comportement de la PR, ou si le nouveau diff est trop volumineux pour une revue incrémentale, Devin peut refaire la revue de l’ensemble de la PR. La limite de dépenses d’auto-review par PR s’applique à l’ensemble des revues, et non à chaque push séparément. Une fois cette limite atteinte, les revues automatiques suivantes sur la PR sont suspendues, mais pas les revues manuelles.

Langue des commentaires de revue

Vous pouvez choisir la langue que Devin Review utilise pour ses commentaires et son analysis dans Settings > Preferences, sous la section Devin Review.
  • Suivre la langue d’affichage (par défaut) — Les commentaires de revue utilisent votre langue d’affichage.
  • Une langue spécifique — Choisissez une langue dans la liste déroulante Comment language pour l’utiliser dans les commentaires de revue à la place de votre langue d’affichage.
Les instructions de langue dans votre REVIEW.md priment sur ce paramètre.

Donner suite à une revue

Résoudre les constats

L’onglet Bugs répertorie les constats selon ce qu’il reste à faire :
  • Needs your attention — Constats ouverts à trier.
  • Devin is fixing — Constats en cours de traitement par la session Devin de la PR. Consultez Correction Automatique.
  • Fixed — Constats clôturés comme corrigés, par vous ou par Devin.
  • Invalidated — Constats clôturés comme ne nécessitant pas de correctif, par vous ou par Devin.
Développez un constat pour en consulter les détails et le traiter. Sélectionnez Mark fixed une fois le problème traité, ou Mark invalid en indiquant éventuellement un motif s’il ne nécessite pas de correctif. Reopen replace un constat invalidé dans Needs your attention. Si un relecteur ne termine pas, un avertissement en haut de l’onglet indique chaque relecteur en échec. Sélectionnez Retry pour relancer leur exécution. Utilisez les filtres de constats pour vous concentrer sur certaines catégories ou sur les problèmes non résolus, marquer les constats comme lus ou non lus, et citer un constat dans la conversation pour poser une question complémentaire. Lors des revues ultérieures de la même PR, Devin détecte les doublons au lieu de traiter chaque résultat comme nouveau, et résout les bugs et indicateurs qu’il a déjà signalés une fois ceux-ci traités : le constat conserve son texte d’origine et reçoit le libellé Devin marked this as resolved.

Commentaires et revues

Sur GitHub, vous pouvez laisser des commentaires, approuver la PR ou demander des modifications directement depuis Devin Review. Pour les autres hébergeurs, consultez la référence des fournisseurs.

Démarrer une revue

Lorsque vous rédigez un commentaire top-level, un nouveau commentaire en ligne ou une réponse dans un fil de discussion existant, le bouton d’envoi propose deux actions : Start a review regroupe vos commentaires dans une revue en attente au lieu de les publier un par un, tandis que Comment les publie immédiatement. Devin Review mémorise la dernière action choisie et l’applique par défaut, y compris pour le raccourci Cmd+Enter ou Ctrl+Enter. Dès qu’une revue est en cours, le bouton devient Add to review et les commentaires suivants y sont ajoutés jusqu’à ce que vous la soumettiez. Il s’agit de votre propre revue à l’intention de l’auteur, et non d’une requête pour une nouvelle analyse par Devin.

Résolution des commentaires

Résolvez un fil de discussion une fois que vous l’avez traité. Sur GitHub, Devin réduit une revue rédigée par un bot dès que tous ses fils de discussion sont résolus, et l’affiche de nouveau si l’un d’eux est rouvert.

Indicateurs de propriétaire du code

Une icône de bouclier à côté d’un relecteur dans la barre latérale indique que sa revue a été demandée en tant que propriétaire du code.

Modifications de code depuis le chat

Demandez à l’agent du chat d’effectuer des modifications de code. Examinez les modifications suggérées, puis appliquez-les sous forme de commit à la branche de la PR sans quitter Devin Review. Cette fonctionnalité se distingue de la Correction Automatique, qui s’appuie sur une session Devin pour traiter les constats.

Actions du workflow des PR

Devin Review vous permet d’agir sur les demandes de fusion (PR) directement depuis la page de revue, sans quitter GitHub.
  • Fusionner — Fusionnez la PR avec n’importe quelle méthode de fusion autorisée par le dépôt (merge commit, squash ou rebase). Si plusieurs méthodes sont autorisées, sélectionnez-la dans le menu déroulant du bouton de fusion ; Devin Review mémorise dans votre navigateur votre dernier choix pour ce dépôt et cette branche de base. Le bouton de fusion reflète l’état actuel de la possibilité de fusion de la PR ainsi que les vérifications requises.
  • Fermer — Fermez la PR sans la fusionner. Disponible dans le menu déroulant à côté du bouton de fusion.
  • Convertir en brouillon — Convertissez une PR ouverte en brouillon. Disponible dans le menu déroulant lorsque la PR est ouverte et n’est pas déjà un brouillon.
  • Marquer comme prête pour la revue — Marquez une PR en brouillon comme prête pour la revue. Un bouton « Ready for review » apparaît dans la barre de fusion pour les PR en brouillon ; son menu propose également Review draft, qui lance une revue sans marquer la PR comme prête.
  • Fusion automatique — Activez ou désactivez la fusion automatique de GitHub depuis le menu déroulant du bouton de fusion. Lorsqu’elle est activée, la PR sera fusionnée automatiquement une fois que toutes les vérifications requises auront été validées. La barre de fusion affiche l’état actuel de la fusion automatique, y compris la personne qui l’a activée.
Les actions ci-dessus s’appliquent à GitHub, où elles nécessitent une connexion via l’application GitHub ainsi que votre identité GitHub liée. Les actions sont désactivées en mode lecture seule. Les autres fournisseurs ne prennent en charge que les actions indiquées dans la section Fournisseurs Git pris en charge.

Raccourcis clavier

m et n agissent immédiatement, comme les boutons qu’ils remplacent : m fusionne donc sans demander de confirmation. Pour modifier une association, accédez à Settings > Keyboard shortcuts.

PR empilées

Devin Review prend en charge les PR empilées de manière native. Lorsqu’une PR fait partie d’une pile, la page de revue affiche toute la série et gère correctement la fusion :
  • Panneau de la pile — L’en-tête de la PR affiche la pile, avec tous ses éléments classés de bas en haut jusqu’à la branche de base dans laquelle ils seront fusionnés. Chaque élément renvoie vers sa propre page de revue, ce qui permet d’examiner la pile couche par couche. L’option Reverse stack order, à côté du nombre d’éléments de la pile, affiche à l’inverse la branche de base en premier ; votre choix est mémorisé.
  • État de préparation par couche — Chaque élément affiche un point d’état reflétant sa réelle possibilité de fusion : vert lorsqu’il peut effectivement être fusionné (en tenant compte de l’IC, des revues requises et de la protection de branche), rouge en cas de vérifications en échec ou de conflits, et orange pour tout autre élément empêchant la fusion — notamment lorsqu’une couche est prête individuellement, mais bloquée par une PR non fusionnable située en dessous. Un indicateur global résume l’état de l’ensemble de la pile.
  • Diffs ciblés — Chaque PR d’une pile est comparée à la couche située juste en dessous, afin que chaque revue — y compris la revue automatique et le Détecteur de bogues — ne porte que sur les modifications de cette couche.
  • Fusion de pile — Les PR empilées sont fusionnées via la fusion atomique de pile de GitHub : fusionner une PR fusionne également toutes les PR ouvertes situées en dessous dans la pile, de bas en haut, en une seule opération. Le bouton de fusion indique exactement combien de PR seront intégrées par l’action, puis GitHub redirige les PR restantes vers la branche de base.
  • Fusion automatique — Vous pouvez activer la fusion automatique de GitHub sur une PR empilée. Dès que la pile est prête, GitHub fusionne la PR ainsi que toutes les PR non fusionnées situées en dessous.
Les PR empilées sont disponibles uniquement pour les dépôts GitHub.com, et leur disponibilité varie également selon le compte. Consultez le guide des PR empilées pour savoir comment Devin crée et maintient les piles.

Attribution des commits et des commentaires

  • Les bugs détectés, les signalements et les annotations automatisées apparaissent toujours sous l’identité du Devin bot.
  • Lorsqu’un utilisateur écrit un commentaire ou une revue via Devin Review, cela apparaît sous l’identité GitHub de l’utilisateur.
  • Lorsqu’un utilisateur demande à l’agent de chat d’effectuer une modification de code, le commit qui en résulte est effectué sous l’identité du Devin bot.
  • Les GitHub Suggested Changes suivent le comportement standard de GitHub : tout relecteur (y compris Devin) peut laisser une modification suggérée dans un commentaire de revue. Appliquer une suggestion ne revient pas à lancer une session de Correction Automatique.
  • Devin ne créera jamais de commits ou de commentaires au nom d’un utilisateur sans que celui-ci n’ait explicitement initié l’action.

Correction Automatique

La Correction Automatique s’appuie sur une session Devin pour traiter les constats de revue d’une PR. Elle se distingue de l’application d’une modification suggérée individuelle ou d’une demande à l’agent de Conversation de Review pour qu’il prépare un commit.

Comment l’activer

Pour une PR déjà rattachée à une session Devin, la Correction Automatique suit le paramètre Automatically fix Devin Review findings : « Devin will automatically triage the findings and decide whether to fix, validate, or escalate them to you. » Ce paramètre comporte une configuration par défaut de l’organisation et un choix personnel :
  1. Pour l’organisation — Les Administrateurs de l’organisation l’activent ou le désactivent dans Settings > Devin, sous Pull requests. Comme l’indique la ligne, « This option configures the default for all users. » Les autres membres ne peuvent pas le modifier. Dans un compte Entreprise, chaque organisation dispose de sa propre valeur par défaut.
  2. Pour vous-même — Activez-le ou désactivez-le pour les PR issues de vos propres sessions dans Paramètres > Préférences, sous Devin sessions. Le commutateur reflète la configuration par défaut de l’organisation tant que vous ne la modifiez pas. Si votre choix diffère de la valeur par défaut, une pastille Reset to organization default s’affiche, avec une explication au survol ; cliquez dessus, ou remettez le commutateur sur la valeur de l’organisation, pour revenir au paramètre de l’organisation. Votre choix personnel prévaut dans les deux sens, y compris pour l’activer au sein d’une organisation où il est désactivé par défaut.
Lorsque ce paramètre est désactivé pour vous sur une PR rattachée à Devin, Enable auto-fix dans la barre latérale de revue l’active uniquement pour vous ; la configuration par défaut de l’organisation reste inchangée. Lorsque la Correction Automatique est désactivée, Fix with Devin peut apparaître sur la carte de PR de la session, sous la carte d’alerte des constats ou dans la barre latérale Bugs de la revue. Ce bouton corrige les constats de cette PR. Pour activer également la Correction Automatique sur les futures PR issues de vos propres sessions, ouvrez More fix options et activez Automatically fix findings on all my PRs. Cela modifie votre propre paramètre, et non la configuration par défaut de l’organisation. Les gestionnaires de revue du compte peuvent également utiliser ce lien Paramètres > Revue pour préparer une règle de revue automatique à l’échelle du compte pour les PR ouvertes par des sessions Devin. La règle s’applique dès que vous l’enregistrez. Aucun brouillon n’est créé si une règle à l’échelle du compte couvre déjà ces PR. Pour une PR sans session Devin liée, Corriger automatiquement avec Devin peut démarrer une session qui prend en charge la PR et traite les bugs détectés ainsi que les vérifications CI obligatoires en échec. Vous devez être autorisé à créer la session et avoir accès à son repository. Dans l’espace de travail à l’échelle du compte, sélectionnez d’abord un environnement ou un outpost. Si votre entreprise exige une balise de session et qu’il n’existe ni balise par défaut ni balise unique autorisée, choisissez-en une lorsque vous y êtes invité. La revue contient des liens vers la session créée et ses commits.
Corriger automatiquement avec Devin active également Automatically fix Devin Review findings pour vous s’il est désactivé.

Constats sur les PR créées par Devin

Lorsqu’une session éligible a ouvert la PR, elle prend en charge les nouveaux constats avant qu’ils ne soient publiés individuellement. Sur GitHub :
  1. La PR affiche le statut Devin is fixing pour les constats, qui passent dans la section Devin is fixing de l’onglet Bugs.
  2. Si l’option Automatically fix Devin Review findings est activée pour le propriétaire de la session et que la surveillance de la PR est active, la session corrige ce qu’elle peut et enregistre une décision pour chaque constat.
  3. Devin publie une revue unique qui récapitule ses corrections, avec le détail sous Fixed by Devin. Les constats qu’il vous laisse sont publiés sous forme de commentaires de revue, conformément à vos paramètres de publication. Les constats invalidés par Devin ne sont pas publiés.
Ce flux nécessite une session éligible, en cours d’exécution ou suspendue, qui a créé la PR, et non une session qui l’a simplement reprise. En l’absence de session éligible, si le paramètre est désactivé ou si la PR est déjà fermée ou fusionnée, les constats sont publiés sur la PR pour revue. Si la session se termine avant d’avoir fini, les constats restants reviennent dans Needs your attention. Sur les autres fournisseurs, la session peut toujours traiter les constats, mais le statut affiché sur la PR est différent.

Autorisations & Contraintes

  • La modification de la configuration par défaut de l’organisation pour Automatically fix Devin Review findings nécessite des autorisations d’administrateur d’organisation. Pour ses propres sessions, le choix de chaque membre prévaut sur la valeur par défaut.
  • Le paramètre Responding to bots dans Settings > Devin > Pull requests continue de régir les commentaires des autres bots ; il ne contrôle plus Auto-Fix.
  • Les commentaires récapitulatifs No Issues Found de Devin Review sont toujours ignorés. Seuls les commentaires signalant de vrais problèmes déclenchent Auto-Fix.
Si Automatically fix Devin Review findings est désactivé lorsque Devin Review publie des constats, un message s’affichera dans la chronologie de la session pour vous proposer de l’activer.

Revue Automatique

Pour la revue des PR dont vous êtes l’auteur, utilisez vos préférences personnelles. Pour la revue des PR de votre équipe, ajoutez une règle dans les paramètres de revue. Dans les deux cas, le repository doit être connecté à Devin, même s’il est public.
Les nouveaux comptes disposent d’emblée d’une règle à l’échelle du compte qui effectue la revue des PR ouvertes par des sessions Devin dès qu’elles sont prêtes, puis à chaque push. Le paramètre Automatically fix Devin Review findings est en outre activé par défaut, afin que ces sessions corrigent les constats. Vous pouvez modifier ou supprimer la règle dans les paramètres de revue. Les comptes Non-Entreprise existants disposant d’une seule organisation ont reçu la même règle et le même paramètre, sauf si un administrateur avait désactivé le paramètre ou supprimé la règle. Dans toutes les autres organisations existantes, les règles restent inchangées, et le paramètre n’est activé que là où Réponse aux bots permettait déjà à Devin d’agir sur les commentaires de Devin Review.

Modes de déclenchement

Choisissez quand une règle s’active :
  • PR is created — Lorsque la PR est ouverte, y compris en tant que brouillon.
  • PR is ready — Lorsque la PR est ouverte directement prête pour la revue ou marquée comme prête.
Choisissez ensuite la fréquence :
  • Only once — Une seule revue lorsque les conditions de déclenchement sont remplies.
  • Every push — Nouvelle revue à chaque push ultérieur. Cette option nécessite le niveau complet de consommation liée aux revues automatiques. Lorsque des autorisations au niveau du dépôt sont utilisées, une règle de dépôt propose Every push si une organisation qui vous accorde un accès en modification à ce dépôt autorise également Every push, même si vous consultez Settings depuis une autre organisation. Consultez Que se passe-t-il au prochain push ? pour savoir ce que couvre une revue de suivi.
La revue automatique n’est pas lancée tant qu’une PR présente des conflits de fusion ; elle s’exécute une fois ceux-ci résolus. La page de revue affiche alors un avertissement Merge conflicts, et vous pouvez toujours lancer une revue manuellement depuis cette page. Les paramètres personnels proposent également le mode Manuel, qui annule votre inscription automatique personnelle. Il ne désactive pas les revues demandées par une autre règle correspondante.

Auto-inscription (tous les utilisateurs)

Lorsque l’inscription personnelle est activée pour votre compte, les utilisateurs disposant d’une identité de fournisseur Git liée et du niveau d’utilisation Review approprié peuvent s’inscrire eux-mêmes, sans autorisations d’administrateur.
  1. Accédez à Paramètres > Préférences.
  2. Sous Devin Review, définissez Analysis trigger sur Analyze PRs automatically when opened ou Analyze PRs automatically when ready for review.
  3. Définissez Analysis frequency sur Only once ou Every push, si vos autorisations le permettent.
Devin effectue la revue des PR éligibles dont vous êtes l’auteur dans les dépôts connectés auxquels il a accès. Si le paramètre affiche des filtres avancés, gérez la règle sous-jacente dans les paramètres de revue au lieu de la remplacer par un déclencheur personnel plus simple. Sur les PR connectées éligibles, vous pouvez également activer ou désactiver l’auto-review depuis le menu d’actions de la page de revue, si vos Autorisations de Revue le permettent. Cette option n’est pas disponible sur toutes les revues publiques ou en lecture seule. L’auto-review peut également être activée directement depuis une PR. Lorsqu’aucune règle ne s’applique à une PR, le statut Devin Review figurant dans sa description contient un lien Enable auto-review, qui ouvre vos paramètres avec un prompt Turn on automatic analysis, ou, si vous pouvez gérer les règles de revue, un brouillon de règle pour le dépôt. La bannière de la page de revue et le bouton Analyze de la carte PR d’une session proposent le même choix : lancer une revue unique de cette PR, ou activer l’auto-review pour This pull request, All my pull requests ou Every pull request in le dépôt, selon vos autorisations et votre compte Git lié.

Règles à portée limitée et exclusions

Les responsables des revues configurent les règles de revue automatique dans l’onglet Review de Paramètres > Revue. La page comporte également les onglets Sécurité, Custom reviewers, Autoapprover et Billing ; l’onglet Sécurité est visible par les responsables des revues du compte. Ouvrez le menu d’ajout sous Automatic analysis (Add repositories or users tant que la liste est vide, Add repository ensuite) et choisissez ce que couvre la règle : Add GitHub organization, Add GitLab group, Add Azure DevOps project, Add Bitbucket workspace ou Add Bitbucket project pour tous les dépôts de cet espace de noms ; Add single repository pour un seul dépôt ; Add user pour toutes les PR créées par un membre du compte ; ou Add advanced rule pour combiner plusieurs conditions. Dans la boîte de dialogue de la règle, choisissez une cible Dépôt ou Organization, puis affinez-la à l’aide de conditions : is et is not comparent le texte exact ; choisissez matches ou does not match pour appliquer un motif glob aux conditions portant sur le dépôt, le titre, la branche et les fichiers modifiés. Choisissez ensuite l’événement déclencheur et la fréquence de la règle. Le paramètre Effort d’analyse de la règle peut reprendre la valeur par défaut du compte ou la remplacer par Normal ou Ultra. Pour les règles automatiques comportant une condition Originated by Devin, le niveau d’utilisation de la personne ayant lancé la session Devin détermine dans quels cas cette condition peut s’appliquer. Un niveau limité à la création autorise la première revue éligible, mais pas les revues sur les push suivants ; un niveau uniquement manuel ou l’absence d’autorisation Review empêche la condition de s’appliquer. Utilisez les exclusions pour les PR que la fonctionnalité ne doit pas traiter. Les exclusions correspondantes l’emportent sur ses règles d’inscription. Lorsqu’une exclusion empêche l’auto-review d’une PR, développez Automatic analysis skipped by an exception pour afficher les règles correspondantes auxquelles vous avez accès. Vous pouvez toujours lancer une revue ponctuelle ; les push suivants restent exclus. La revue automatique, chaque réviseur personnalisé et Autoapprover ont chacun leurs propres règles. Activer la revue automatique standard n’active ni Autoapprover ni un réviseur personnalisé dépourvu de règle correspondante. Une exclusion Autoapprover ne désactive pas la revue automatique standard. Les règles remplacent les anciennes listes d’inscription par dépôt et personnelles. Les anciennes entrées d’inscription ne déclenchent plus de revues ; configurez plutôt les règles correspondantes. Sous Git provider interaction, les responsables des revues du compte peuvent également désactiver Let Devin Review edit the PR description (activé par défaut), qui ajoute un lien et le statut de la revue à la description de pull request. Lorsque cette option est désactivée, votre description n’est pas modifiée et, sur GitHub, le lien et le statut figurent à la place dans un commentaire sur la PR.

Publication sur GitHub

Les responsables des revues du compte peuvent configurer ce que Devin publie sur le fournisseur Git connecté depuis Paramètres > Revue. La section Post findings to, dont le nom reprend celui de vos fournisseurs connectés, permet de choisir quels types de constats sont publiés sous forme de commentaires : les bugs et les indicateurs dans l’onglet Review, et les constats de sécurité dans l’onglet Sécurité. La section Git provider interaction de l’onglet Review regroupe les interrupteurs de la vérification CI et du lien dans la description de pull request :
  • Post CI check — Lorsque cette option est activée (par défaut), Devin crée un statut de commit Devin Review sur les fournisseurs pris en charge pour chaque revue. Passing condition détermine à quel moment la vérification est considérée comme réussie : revue terminée (par défaut), fils de discussion résolus ou aucun constat. Sur Azure DevOps, le statut est publié sur le commit ainsi que sur la pull request elle-même : il apparaît donc dans la liste des statuts de la pull request et peut être rendu obligatoire au moyen d’une politique de branche Status (genre devin, nom Devin Review). Définissez l’Authorized identity de la politique sur le compte avec lequel Devin publie, afin qu’aucune autre identité ne puisse la satisfaire.
  • Bugs — Publiez les bugs (erreurs probables ou comportement incorrect) sous forme de commentaire sur les PR.
  • Sécurité — Publiez les vulnérabilités de sécurité et les suggestions de renforcement sous forme de commentaire sur les PR.
  • Flags (investigate) — Publiez les indicateurs d’investigation (problèmes potentiels qui méritent un examen plus approfondi) sous forme de commentaire sur les PR.
  • Flags (note) — Publiez les indicateurs d’information (observations qui peuvent ne nécessiter aucune action) sous forme de commentaire sur les PR.
Par défaut, les bugs et les constats de sécurité sont publiés sous forme de commentaire sur les PR. Les indicateurs d’investigation et d’information ne le sont pas. Les administrateurs peuvent activer ou désactiver chaque type de résultat indépendamment. Lorsque l’option Add an override est disponible, utilisez-la pour remplacer les catégories de publication par défaut pour un dépôt ou un périmètre de dépôts pris en charge. Ce paramètre détermine ce qui est publié, et non le déclenchement de la revue. Si vous ne sélectionnez aucune catégorie, aucun commentaire de constat n’est publié pour ce périmètre.
Comptes d’entreprise : les paramètres s’appliquent à toutes les organisations de l’Enterprise. Les contrôles de publication à l’échelle du compte nécessitent l’autorisation Manage Review au niveau du compte ; la gestion des règles au niveau de l’organisation ne confère pas l’autorisation de modifier ces valeurs par défaut. La page des paramètres de revue propre à une organisation ne couvre que les dépôts de cette organisation et verrouille les paramètres définis à l’échelle de l’entreprise, signalés par la mention Enterprise-level setting ; pour les modifier, passez par les paramètres de revue de l’Enterprise.

Fichiers d’instructions

Devin Review respecte les fichiers d’instructions dans votre dépôt. Si l’un de ces fichiers existe, il sera utilisé comme contexte lors de l’analyse de votre PR :
  • **/REVIEW.md
  • **/AGENTS.md
  • **/CLAUDE.md (insensible à la casse)
  • **/CONTRIBUTING.md (insensible à la casse)
  • .cursorrules
  • .windsurfrules
  • .cursor/rules
  • *.rules
  • *.mdc
  • .coderabbit.yaml / .coderabbit.yml
  • greptile.json
Les fichiers situés dans des sous-répertoires de type agent (.agents/, .devin/, agents/, .cursor/, .github/) sont traités comme appartenant au répertoire parent à des fins de périmètre. Par exemple, src/.agents/REVIEW.md s’applique aux fichiers sous src/. Ces fichiers fournissent du contexte pour la revue. Si vous souhaitez une vérification nommée qui remonte ses propres constats, configurez plutôt un relecteur personnalisé.

REVIEW.md

REVIEW.md est un fichier d’instructions dédié pour Devin Review. Placez‑le n’importe où dans votre dépôt pour personnaliser la façon dont Devin examine les PR (pull requests) dans votre projet. Devin détecte automatiquement les fichiers REVIEW.md à n’importe quel niveau de répertoire (**/REVIEW.md), ce qui vous permet de restreindre les consignes de revue à des sous‑répertoires spécifiques si nécessaire. Utilisez REVIEW.md pour définir des consignes propres à la revue, par exemple :
  • Parties du code qui nécessitent une attention particulière
  • Pièges courants ou anti‑patterns à surveiller
  • Conventions propres au projet que les relecteurs doivent faire respecter
  • Fichiers ou répertoires qui peuvent être ignorés sans risque pendant la revue
  • Considérations de sécurité ou de performance propres à votre projet
Exemple de REVIEW.md :

Règles de revue personnalisées

Vous pouvez configurer des fichiers supplémentaires à utiliser comme contexte de revue dans Paramètres > Revue, sous Context. Ces motifs de fichiers sont distincts des relecteurs personnalisés : ils fournissent des informations de contexte, sans définir de relecteur produisant ses propres constats. Pour ajouter des fichiers du dépôt :
  1. Repérez la section Context dans l’onglet Review des paramètres de revue.
  2. Sélectionnez Add context. Selon le cas, la fenêtre Add repository files s’ouvre directement, ou un menu s’affiche dans lequel vous pouvez choisir Repository files.
  3. Saisissez un motif glob de fichiers, par exemple docs/architecture/**/*.md, puis ajoutez-le.
Les motifs s’appliquent à l’ensemble du compte : les fichiers correspondants sont lus dans le dépôt en cours de revue, en commençant par ceux les plus proches des fichiers modifiés. Vous pouvez modifier ou supprimer les motifs personnalisés depuis la liste.

Instructions de contexte de revue (Beta)

Les instructions de contexte de revue rédigées sont en Beta et nécessitent un accès bêta. Les fichiers d’instructions du dépôt restent disponibles indépendamment de cette fonctionnalité.
Utilisez les instructions de contexte de revue pour définir des consignes que vous souhaitez gérer de manière centralisée, sans ajouter de fichiers à vos dépôts.
  1. Ouvrez Settings > Review et repérez la section Context.
  2. Ouvrez le menu d’ajout et choisissez Managed instructions, signalé par la mention Beta.
  3. Saisissez un titre et les consignes de revue.
  4. Choisissez All repositories ou un périmètre de dépôts plus restreint.
  5. Cliquez sur Add context.
Par exemple :
Modifiez ou supprimez une entrée lorsque les consignes évoluent. La gestion de ces instructions nécessite l’autorisation Manage Review au niveau du compte. Utilisez plutôt des fichiers du dépôt lorsque les consignes doivent être placées sous contrôle de version avec le code.

Relecteurs personnalisés (Bêta)

Les relecteurs personnalisés sont en Bêta. Si vous ne pouvez pas créer ou configurer de relecteur, adressez-vous à un Review manager de votre organisation ou de votre compte.
Un relecteur personnalisé analyse les PR selon les instructions que vous rédigez et produit des constats qui lui sont attribués. Utilisez-en un pour un besoin précis, comme la compatibilité des API, les migrations de base de données, l’accessibilité ou les exigences en matière de tests. Utilisez le contexte de revue pour les informations générales et les conventions communes, et un relecteur personnalisé lorsque vous souhaitez une vérification dédiée, avec un nom, ses propres instructions, ses propres constats et ses propres règles d’inscription.

Créer un relecteur

  1. Ouvrez Settings > Review et sélectionnez l’onglet Custom reviewers.
  2. Sélectionnez Add reviewer, puis saisissez un Name et, si vous le souhaitez, une description.
  3. Sous Instructions, choisissez Plain text et décrivez ce qu’il faut vérifier et ce qu’il faut ignorer, ou choisissez Repository skill ou Organization skill (Enterprise skill dans une Enterprise) pour vous appuyer sur une skill existante.
  4. Choisissez le niveau Finding urgency : Severe pour les problèmes à corriger impérativement, Moderate pour les points qui méritent d’être examinés, ou Info pour les suggestions et les éléments de contexte.
  5. Sélectionnez Create and enable, ou Save as draft pour terminer plus tard.
  6. Ouvrez le relecteur et vérifiez la section Rules. Si vous pouvez gérer Review pour l’ensemble du compte, l’option Run with Devin Review est activée par défaut pour tout nouveau relecteur, qui participe ainsi à chaque revue. Pour le limiter à certaines PR, désactivez cette option et sélectionnez Add reviewer rule. Dans le cas contraire, le relecteur est créé sans aucune règle : ajoutez-en une pour choisir les PR qu’il vérifie.
Une règle avec le déclenchement Whenever Devin Review runs ne lance jamais de revue à elle seule : le relecteur participe à toute revue d’une PR correspondante, quelle que soit la façon dont cette revue a été lancée. Sur GitHub, choisissez Only once et CI check pour lancer un réviseur personnalisé une fois qu’un check donné a réussi sur le commit actuel d’une PR ouverte et prête pour la revue. Saisissez le nom exact du check. Les statuts de commit GitHub ne sont pas pris en compte comme des exécutions de check, et ce déclenchement n’est pas disponible pour la revue intégrée. Un relecteur activé sans règle correspondante ne s’exécute pas. Les relecteurs en brouillon ou désactivés ne s’exécutent pas, même si leurs règles correspondent. Les exclusions correspondantes ont priorité sur les règles. Par exemple, créez un relecteur API compatibility pour votre dépôt d’API :

Réutiliser une skill

Un relecteur créé à partir d’une Repository skill, d’une Organization skill ou d’une Enterprise skill a l’option Keep the reviewer in sync with the skill cochée par défaut : ses instructions sont alors en lecture seule dans le relecteur et suivent les modifications de la skill. Une skill de dépôt est lue depuis la branche par défaut du dépôt (généralement main ou master). Les skills de dépôt sont proposées à partir des répertoires de skills d’agent (comme .agents/skills/ ou .devin/skills/) et de tout module d’extension présent dans le dépôt, via les répertoires indiqués dans le champ skills de son fichier .devin-plugin/plugin.json ou .claude-plugin/plugin.json, ou à défaut son répertoire skills/. Si vous décochez cette option, le relecteur conserve son texte actuel et les mises à jour de la skill sont soumises à votre approbation. Pour modifier vous-même les instructions, sélectionnez Change source… puis passez à Plain text : le relecteur est alors dissocié de sa skill et conserve le texte actuel.
Dans une Entreprise, les relecteurs sont partagés. Le texte de la skill d’une organisation, y compris ses modifications ultérieures, n’est lisible que par les membres de cette organisation ; les autres Review managers peuvent toutefois modifier les autres paramètres du relecteur.

Constats et vérifications CI

Les constats indiquent le nom du relecteur et le niveau d’urgence configuré. View runs affiche l’historique des exécutions de chaque relecteur, avec le nombre de constats corrigés et ignorés, et permet de filtrer les exécutions selon le sort réservé aux constats. Chaque relecteur dispose également d’une section CI check. Son paramètre Post CI check détermine si les constats du relecteur sont comptabilisés dans le check Devin Review (Part of Devin Review) ou publiés dans un check distinct (Separate check) portant le nom du relecteur, par exemple Devin Review / API compatibility. La condition de réussite (Passing condition) d’un check distinct peut être :
  • Reviewer finishes — il suffit que le relecteur ait terminé, même s’il a détecté des problèmes.
  • All comments are resolved — les commentaires qu’il a publiés ont tous été résolus.
  • There are no open findings — tous ses constats sont clos.
Les checks distincts nécessitent l’activation du paramètre Post CI check au niveau du compte. S’il est désactivé et que vous ne pouvez pas l’activer, contactez un administrateur du compte. Publier un check n’en fait pas pour autant une condition de fusion : pour bloquer les fusions, configurez le check affiché comme obligatoire dans les règles de branche de votre dépôt.

Limite de dépenses

La section Spend limit de chaque relecteur détermine ce qu’il peut dépenser pour les revues automatiques d’une même PR. Le champ Budget propose deux options :
  • Part of Devin Review limit (par défaut) — Les dépenses du relecteur sont imputées sur la limite de dépenses d’auto-review par PR. Vous pouvez facultativement définir Limit per pull request pour plafonner le relecteur en deçà de cette limite.
  • Separate budget — Le relecteur dépense sur sa propre Limit per pull request, alors obligatoire, et continue de s’exécuter une fois la limite de Devin Review atteinte. Seuls les gestionnaires de Review au niveau du compte peuvent choisir cette option.
Cette limite s’exprime dans la même unité que la limite de dépenses d’auto-review par PR. Une fois sa limite atteinte, le relecteur est ignoré lors des revues automatiques suivantes de cette PR, et son exécution affiche Skipped: spend limit reached. Les revues que vous lancez manuellement ne sont pas soumises aux limites des relecteurs.

Historique des versions et archivage

Sélectionnez Last updated on … sur la page du relecteur pour ouvrir son historique des versions. Celui-ci répertorie les 20 versions les plus récentes des instructions, chacune accompagnée des modifications apportées par rapport à la version précédente. Restore enregistre les instructions d’une version antérieure comme nouvelle version. Un relecteur qui suit une skill ne peut pas restaurer une version antérieure tant qu’il suit cette skill. Désactivez un relecteur pour interrompre ses exécutions futures tout en conservant sa configuration. L’archivage le déplace dans Archived reviewers, sous la liste des relecteurs, et met fin à ses exécutions ; les constats qu’il a déjà publiés sont conservés. Restore rétablit un relecteur archivé à l’état désactivé : il ne s’exécutera donc pas tant que vous ne l’aurez pas activé.

Autoapprover (Bêta)

Autoapprover est en Bêta et nécessite un accès bêta.
Autoapprover détermine si certaines PR peuvent être approuvées sans revue manuelle. Soit il approuve le commit examiné, soit il laisse la PR à une personne pour qu’elle en fasse la revue. Il est conçu pour les repositories qui exigent une revue approuvée avant la fusion. Son approbation compte comme une revue approuvée de la part de Devin, et non comme une revue d’un code owner. Les instructions personnalisées sont facultatives. Dès que vous avez activé Autoapprover pour certaines PR au moyen d’une règle, il fonctionne immédiatement grâce à une grille d’évaluation intégrée :
  • Intention : la modification correspond-elle à l’intention déclarée par l’auteur de la PR ?
  • Qualité du code : la modification préserve-t-elle la maintenabilité de la base de code et sa facilité de revue ?
  • Risque d’incident : un problème dans la modification pourrait-il provoquer un incident de fiabilité ou de sécurité ?
Autoapprover tient compte des constats de la revue en plus de cette grille. Inutile de rédiger un prompt avant de l’utiliser.
Lorsque le Shadow mode est désactivé, Autoapprover publie de véritables approbations. Commencez par un périmètre restreint et examinez ses décisions avant de l’élargir. Il ne fusionne pas les PR lui-même, mais une approbation peut satisfaire une exigence du repository et débloquer une configuration existante de fusion automatique ou de file de fusion.

Installation d’Autoapprover

  1. Ouvrez Paramètres > Revue et sélectionnez l’onglet Autoapprover. Si l’onglet indique qu’Autoapprover n’est pas encore disponible pour votre compte, c’est que votre compte n’a pas accès à la bêta.
  2. Ajoutez une règle Autoapprover en sélectionnant le dépôt et les conditions de PR à évaluer.
  3. Facultativement, ajoutez des exclusions Autoapprover pour les PR que vous ne souhaitez jamais soumettre à son évaluation.
Une règle correspondante est obligatoire, contrairement aux instructions personnalisées. Autoapprover évalue les PR inscrites à chaque push, et les exclusions correspondantes sont prioritaires. Les évaluations incrémentielles tiennent compte de la décision précédente et des nouvelles modifications, et procèdent à une réévaluation complète si nécessaire. Les Review managers du compte peuvent activer le Shadow mode pour publier les verdicts sous forme de commentaires, sans approuver les PR ni retirer d’approbations. La carte Approvals affiche les verdicts récents et leurs résultats. Les règles Always approve approuvent les PR inscrites correspondantes sans les évaluer, sauf si un constat est ouvert ou si la PR modifie la politique d’approbation ; une condition de fichier doit correspondre à chacun des fichiers modifiés. Les règles Always deny laissent les PR correspondantes à l’appréciation d’une personne et sont prioritaires sur Always approve.

Instructions personnalisées facultatives

Pour adapter la grille d’évaluation par défaut, sélectionnez Add instructions sous Instructions et choisissez où elles s’appliquent. Décrivez ce que votre équipe accepte d’approuver automatiquement et ce qui nécessite toujours une intervention humaine. Pour les critères qu’elles couvrent, ces instructions priment sur la grille d’évaluation par défaut ; en cas de conflit entre instructions, celles dont le périmètre est le plus restreint l’emportent. Autoapprover ignore les instructions qu’il ne peut pas vérifier, comme celles qui dépendent du statut de la CI, et précise dans son verdict celles qu’il a ignorées. Lorsque Autoapprover s’appuie sur la grille d’évaluation pour évaluer une PR, il lit également les fichiers APPROVAL_POLICY.md et AUTOAPPROVE.md (l’ancien nom) situés à la racine du dépôt, ainsi que dans les répertoires des fichiers modifiés et dans leurs répertoires parents. Autoapprover lit ces fichiers depuis la branche cible de la PR (une PR ne peut donc pas définir ses propres règles d’approbation), puis transmet leur contenu au relecteur sous forme d’instructions. Toute PR qui modifie un fichier APPROVAL_POLICY.md ou AUTOAPPROVE.md nécessite systématiquement une revue manuelle. Les instructions orientent les décisions, mais ne suffisent pas à elles seules à inscrire des PR. Par exemple, après avoir ajouté une règle limitée à un dépôt de documentation, vous pourriez facultativement ajouter :
Les instructions orientent le jugement du relecteur ; elles ne sont pas appliquées comme des règles strictes. Utilisez les exclusions d’Autoapprover pour les cas qui ne doivent jamais faire l’objet d’une approbation automatique, comme les modifications sous .github/ ou les diffs dépassant une taille limite. Maintenez la protection de branche et les contrôles d’accès.

Comprendre le résultat

La section Autoapprover de la PR affiche son résultat et son raisonnement :
  • Autoapproved — Devin a approuvé la PR.
  • Not autoapproved — la PR nécessite une revue manuelle.
  • Approved by a person — une personne a donné son approbation.
En Shadow mode, la section affiche un badge Shadow et indique ce que Devin aurait fait, par exemple « Devin would have approved this pull request. No action was taken. » Les verdicts en mode Shadow n’approuvent jamais la PR et ne retirent jamais d’approbation existante. Lorsqu’Autoapprover évalue une PR à l’aide de la grille d’évaluation et trouve des fichiers de stratégie non vides, son raisonnement inclut une ligne Policy read from: qui indique leurs chemins. Cette ligne n’apparaît pas dans les résultats issus d’une règle Always approve ou Always deny, dans les résultats concernant une PR qui modifie un fichier de stratégie, ni dans les résultats antérieurs à son ajout. Son absence confirme donc uniquement qu’une évaluation par grille n’a trouvé aucun fichier de stratégie. Lorsqu’Autoapprover laisse une PR en attente de revue manuelle, il publie également sur la PR un commentaire de revue, Autoapprover left this pull request for human review., accompagné de son raisonnement. Chez les fournisseurs qui permettent de modifier une revue, les évaluations suivantes réécrivent directement cette revue au lieu d’en ajouter une nouvelle. Si une évaluation ultérieure menée à terme change la décision, Autoapprover peut retirer son approbation précédente. S’il ne parvient pas à mettre à jour l’approbation, l’UI vous invite à vérifier si la PR comporte toujours une approbation de Devin. Une évaluation en échec ou ignorée ne garantit pas qu’une approbation antérieure a été retirée. GitHub interdit aux auteurs de PR de faire la revue de leurs propres PR. Assurez-vous donc que Devin ouvre les PR GitHub sous votre propre nom (liez votre compte GitHub) pour qu’elles puissent être approuvées par Devin. Supprimer une règle met fin aux évaluations futures des PR qui ne correspondent qu’à cette règle ; cela ne signifie pas pour autant que les approbations déjà publiées ont été révoquées. En cas de résultat inattendu, vérifiez l’approbation sur le fournisseur Git, restreignez la règle et envoyez à votre représentant Cognition le lien de la PR ainsi que les instructions pertinentes.

Autorisations et coût

Autorisations

L’accès à Devin Review est contrôlé par les autorisations Devin Review dans l’éditeur de rôles. Les niveaux d’utilisation distinguent la revue manuelle, la revue à la création d’une PR et la revue automatique complète. La configuration à l’échelle du compte nécessite l’autorisation Manage Review (affichée sous le nom Manage Devin Review dans certains éditeurs de rôles) ; une attribution d’autorisation sur un dépôt peut suffire pour les règles qu’elle couvre, comme décrit ci-dessous. Les Enterprise Admin peuvent utiliser les rôles personnalisés pour restreindre l’utilisation ou donner accès à la configuration. Les autorisations au niveau du compte régissent la configuration à l’échelle du compte ; les autorisations de revue au niveau de l’organisation régissent l’accès au sein des organisations de l’entreprise. Si des attributions d’autorisation sur les dépôts sont utilisées, une attribution permettant de configurer Review pour un dépôt ou une connexion Git peut également vous donner accès à Paramètres > Revue pour les règles qu’elle couvre. Lorsqu’elle est activée, l’auto-inscription ne nécessite pas l’autorisation Manage Review, mais les modes de déclenchement disponibles dépendent de votre niveau d’utilisation. Consultez Rôles au niveau du compte pour obtenir la liste complète des niveaux d’autorisation Devin Review et des droits accordés par chacun. La gestion des règles de revue automatique et des exclusions d’une organisation nécessite l’autorisation d’organisation Manage analysis rules, que le rôle d’organisation intégré Review manager accorde en plus des autorisations de membre.
Comptes d’entreprise : les responsables des revues d’une organisation peuvent configurer les portées autorisées sans être administrateurs de l’organisation principale. Les contrôles à l’échelle du compte, tels que les paramètres de publication par défaut et les instructions de contexte de revue, nécessitent toujours l’autorisation Manage Review au niveau du compte. La politique de l’entreprise peut interdire les modifications au niveau de l’organisation.

Contrôle des coûts

Devin Review consomme des ACUs (unités de calcul agent) du pool d’ACU de votre entreprise, le même pool que celui utilisé par les sessions Devin et les autres produits Devin. Les Enterprise Admin disposent de plusieurs outils pour surveiller et contrôler les coûts de Devin Review.
Les contrôles d’organisation et de consommation Enterprise nécessitent un compte Devin Enterprise. Les limites de dépenses par PR pour les revues automatiques s’appliquent également aux forfaits basés sur un quota. Pour les forfaits entreprise, contactez l’équipe commerciale.
Devin Review propose un essai gratuit de 14 jours, qui débute avec votre première revue. À l’issue de l’essai, les analyses consomment des crédits.

Tableau de bord de consommation

Le tableau de bord de consommation de l’entreprise, accessible depuis Settings > Consumption, détaille l’utilisation des ACU par produit, avec notamment une ligne Review dédiée dans le graphique de consommation quotidienne. Les administrateurs de l’organisation peuvent consulter la consommation de revue de leur organisation depuis Settings > Consumption Analytics. Le tableau de bord inclut :
  • Répartition par utilisateur — Voyez combien d’ACU de revue chaque utilisateur a consommés pendant le cycle de facturation en cours et le précédent.
  • Répartition par dépôt — Voyez la consommation d’ACU de revue, le nombre de revues et le nombre de bugs détectés par dépôt pendant le cycle de facturation en cours et le précédent, afin d’identifier quels dépôts génèrent les coûts de revue les plus élevés et où les revues détectent le plus de problèmes.
L’utilisation de Devin Review est décomptée du budget de son organisation de facturation. Une fois ce budget épuisé, les revues complètes ne sont plus effectuées ; consultez Que se passe-t-il lorsqu’un budget est épuisé. Si vous avez accès à Settings > Analytics > Review, utilisez cette vue pour suivre le devenir des constats, par exemple combien ont été corrigés ou rejetés. Filtrez sur un réviseur personnalisé pour afficher ses résultats, ou sélectionnez Autoapprover, lorsqu’il est disponible, pour consulter les taux d’approbation et les verdicts.

Indicateur de taille de la revue

Chaque PR dans Devin Review affiche une pastille de consommation indiquant la taille de la revue (XS, S, M, L ou XL) en fonction de l’utilisation totale d’ACU sur l’ensemble des jobs de revue de cette PR : Survolez la pastille pour voir le total exact d’ACU, le nombre de jobs de revue exécutés et le coût de la revue actuellement affichée. Cela aide les relecteurs à comprendre l’impact sur les coûts d’une nouvelle exécution des revues ou de l’activation de la revue automatique sur des PRs avec beaucoup de changements.

Limite de dépenses d’auto-review par PR

Les administrateurs peuvent plafonner les dépenses de Devin Review pour les revues automatiques d’une seule PR depuis Paramètres > Revue, dans l’onglet Billing, sous Limites d’analyse automatique. La limite est mesurée en ACU pour les forfaits basés sur les ACU, ou en dollars de dépenses à la demande pour les forfaits basés sur un quota. Si vous laissez le champ vide, la valeur par défaut gérée par Cognition et affichée dans les paramètres s’applique ; cela ne signifie pas une absence de limite. Une fois que les dépenses totales de revue d’une PR, toutes tâches de revue confondues, atteignent la limite, l’auto-review est désactivée pour cette PR et les futures auto-reviews ne sont plus lancées. Cette limite constitue un blocage souple :
  • Les revues manuelles fonctionnent toujours — la limite met uniquement en pause les revues automatiques. Vous pouvez toujours déclencher vous-même une revue depuis la page de revue de PR.
  • Réactiver par PR — Réactiver l’auto-review depuis le menu d’actions de la PR relance les revues et ajoute une nouvelle enveloppe de budget. Les dépenses enregistrées ne sont pas réinitialisées, et les revues automatiques peuvent de nouveau être mises en pause une fois ce nouveau budget épuisé.
L’affichage de la consommation indique la consommation liée aux revues et l’état de la limite. Si les mises à jour de description de PR sont activées, la ligne de statut Devin Review dans la description de la PR indique également quand l’auto-review a été mise en pause par la limite de dépenses, avec un lien pour la réactiver.

Effort de revue et organisation de facturation

Le paramètre Effort d’analyse, dans les paramètres de revue, permet à un responsable des revues du compte de choisir l’effort par défaut : Normal ou Ultra. Normal privilégie le rapport qualité-prix ; Ultra effectue une revue plus approfondie, pour un coût plus élevé. Les comptes d’entreprise disposent également d’un paramètre Organisation de facturation par défaut pour l’analyse automatique dans l’onglet Billing, qui s’applique aux revues dont l’organisation de facturation ne peut pas être déterminée autrement. Ce paramètre nécessite l’autorisation account-settings. Lorsque la mention d’auteur par organisation est activée, l’affichage de la consommation de revue peut indiquer quelle organisation, ou le compte lui-même, a été facturée pour la revue la plus récente. Lorsque les règles de facturation par dépôt sont disponibles dans l’onglet Billing, les responsables des revues d’une organisation peuvent modifier les règles des dépôts délégués et imputer les revues à une organisation ou à un budget éligible qu’ils gèrent. En revanche, ils ne peuvent pas modifier une règle qui impute déjà les coûts à un payeur qu’ils ne gèrent pas.

Fournisseurs Git pris en charge

GitHub comprend GitHub.com, GitHub Enterprise Server et GitHub Enterprise Cloud, qui disposent tous des fonctionnalités de ce tableau. Les PR empilées ne sont disponibles que sur GitHub.com. Les fonctionnalités d’écriture (commentaires, revues, actions de fusion, modification de code depuis le chat) nécessitent une connexion via une GitHub App installée sur votre organisation GitHub. Les connexions par PAT sont en lecture seule. Comme elles n’envoient pas non plus de webhooks, elles ne permettent pas d’exécuter la revue automatique. GitLab comprend GitLab.com et GitLab autogéré. Connectez le dépôt à Devin et liez votre compte GitLab personnel pour que les commentaires, revues et actions de workflow prises en charge soient effectués en votre nom. Pour configurer la connexion, consultez le guide d’intégration de GitLab autogéré. Sur les projets GitLab où les merge trains sont activés, utilisez Add to merge queue pour placer une demande de fusion éligible dans le train dès que son pipeline en cours est terminé. Tant que la demande se trouve dans le train, Review lui attribue le statut Queued. Review ne programme aucune entrée dans le train tant que le pipeline est en cours d’exécution. C’est GitLab qui choisit la méthode de fusion, en conservant le paramètre de squash déjà défini pour la demande de fusion. Azure DevOps comprend Azure DevOps Services (dev.azure.com) et Azure DevOps Server 2020/2022. Connectez-vous via l’intégration Azure DevOps, un principal de service Microsoft Entra ou une collection Azure DevOps Server avec un jeton d’accès personnel, puis inscrivez les dépôts à la revue automatique depuis Paramètres > Revue. Devin publie les constats automatisés via l’identité de service connectée. Pour commenter, répondre, résoudre des fils de discussion, voter sur une PR ou abandonner une PR en votre nom, liez votre compte Azure DevOps personnel à Devin. Les actions effectuées au nom de l’utilisateur nécessitent une identité Microsoft déléguée prise en charge, ce que ne fournit pas un PAT de serveur partagé. Les modifications issues du chat peuvent être appliquées en un seul commit, et les comptes liés peuvent afficher la liste de leurs PR dans Review. La fusion, les actions de brouillon et la fusion automatique ne sont pas disponibles. Bitbucket Data Center nécessite la version 8.16 ou ultérieure, connectée via l’intégration Bitbucket. Pour commenter, ajouter ou retirer des relecteurs, approuver ou refuser une PR depuis Devin Review, liez votre compte Bitbucket. La fusion, les libellés, les responsables et les réactions ne sont pas disponibles, et les modifications de code depuis le chat sont validées fichier par fichier. Bitbucket Cloud (bitbucket.org) est pris en charge via l’intégration Bitbucket. Connectez votre espace de travail avec un jeton d’accès ou un compte Devin dédié lié via OAuth disposant des droits d’administration sur les dépôts (Devin installe lui-même les webhooks nécessaires à la revue automatique), puis ajoutez des règles de revue automatique depuis Paramètres > Revue. Les commentaires, les réponses et les refus de PR effectués depuis Devin Review sont publiés en votre nom, avec votre propre compte Bitbucket. La demande de relecteurs, la fusion, les actions de brouillon, la fusion automatique, les libellés, les responsables et les réactions ne sont pas disponibles. Les modifications de code depuis le chat sont validées en un seul commit. Perforce Swarm prend en charge l’analyse des revues et les constats automatisés via l’identité de service de la connexion. Sur ce fournisseur, l’UI de Devin Review est en lecture seule pour les commentaires humains et les actions d’approbation, et elle ne peut pas appliquer les modifications issues du chat sous forme de commits. Les revues Swarm n’apparaissent pas dans la boîte de réception personnelle des PR. Les connexions Perforce sont réservées à certains comptes.