Effectuer la revue d’une pull request
Déclencher une revue depuis un commentaire sur les PR
- Sur une pull request GitHub ou une demande de fusion GitLab ouverte, publiez un nouveau commentaire :
/devin review. - 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.
- 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.
/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 utiliserowner/repo#123. - Depuis GitHub.com : remplacez
github.compardevinreview.comdans 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.
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é.Parcourir les modifications et l’historique des revues
- 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+FouCtrl+Fpour 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.
Fichiers générés et limites de taille du diff
Les fichiers marquéslinguist-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 :
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
- 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
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.
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.
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 raccourciCmd+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,squashourebase). 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.
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.
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 :- 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.
- 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.
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 :- La PR affiche le statut Devin is fixing pour les constats, qui passent dans la section Devin is fixing de l’onglet Bugs.
- 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.
- 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.
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.
- 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.
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.- Accédez à Paramètres > Préférences.
- Sous Devin Review, définissez Analysis trigger sur Analyze PRs automatically when opened ou Analyze PRs automatically when ready for review.
- Définissez Analysis frequency sur Only once ou Every push, si vos autorisations le permettent.
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 Reviewsur 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 (genredevin, nomDevin 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.
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.ymlgreptile.json
.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
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 :- Repérez la section Context dans l’onglet Review des paramètres de revue.
- 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.
- Saisissez un motif glob de fichiers, par exemple
docs/architecture/**/*.md, puis ajoutez-le.
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é.
- Ouvrez Settings > Review et repérez la section Context.
- Ouvrez le menu d’ajout et choisissez Managed instructions, signalé par la mention Beta.
- Saisissez un titre et les consignes de revue.
- Choisissez All repositories ou un périmètre de dépôts plus restreint.
- Cliquez sur Add context.
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.
Créer un relecteur
- Ouvrez Settings > Review et sélectionnez l’onglet Custom reviewers.
- Sélectionnez Add reviewer, puis saisissez un Name et, si vous le souhaitez, une description.
- 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.
- 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.
- Sélectionnez Create and enable, ou Save as draft pour terminer plus tard.
- 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.
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éralementmain 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 exempleDevin 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.
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.
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.
- 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é ?
Installation d’Autoapprover
- 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.
- Ajoutez une règle Autoapprover en sélectionnant le dépôt et les conditions de PR à évaluer.
- Facultativement, ajoutez des exclusions Autoapprover pour les PR que vous ne souhaitez jamais soumettre à son évaluation.
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 fichiersAPPROVAL_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 :
.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.
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.
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.
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é.
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
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.
