Passer au contenu principal
À mesure que les agents de codage se généralisent, le goulot d’étranglement se déplace de l’écriture du code vers sa relecture. Devin Review est une plateforme complète de revue de code intégrée à l’application web Devin, qui transforme de volumineuses PR GitHub complexes en diffs organisés de façon intuitive et en explications précises.
Devin Review est gratuit et disponible pour les PR sur les dépôts GitHub classiques (hors GitHub Enterprise). Les PR publiques ne nécessitent pas de compte Devin. Les PR privées peuvent être consultées avec un compte Devin ou via le CLI.

Fonctionnalités

Organisation intelligente des diffs

Regroupe les modifications de manière logique, en réunissant les modifications connexes plutôt qu’en les classant par ordre alphabétique.

Détection des copies et déplacements

Détecte quand du code a été copié ou déplacé et affiche les changements de façon claire, plutôt que d’afficher des suppressions et insertions complètes.

Détecteur de bugs

Vérifie la présence de bugs et les classe par niveau de confiance. Les bugs graves nécessitent une attention immédiate.

Compatibilité GitHub

Laissez des commentaires, approuvez des PR, demandez des changements — le tout dans Devin Review, synchronisé avec GitHub.

Chat contextuel à la base de code

Posez des questions sur la PR et obtenez des réponses avec le contexte pertinent provenant du reste de la base de code. Vous pouvez également solliciter Devin directement depuis n’importe quel commentaire, bug ou marqueur dans la vue diff.

Mise en route

  • Application web Devin — Rendez-vous sur app.devin.ai/review pour voir vos pull requests (PR) ouvertes, classées par catégorie (celles qui vous sont attribuées, celles que vous avez créées, celles pour lesquelles un examen est demandé). Lorsque Devin crée des PR, vous verrez un bouton « Review » orange dans le chat.
  • Raccourci d’URL — Pour tout lien de PR GitHub, remplacez github.com par devinreview.com dans l’URL. Pour les PR privées, connectez-vous d’abord à Devin ou utilisez la CLI.
  • CLI — Exécutez npx devin-review {pr-url} depuis un clone local du dépôt. Voir CLI ci-dessous pour plus de détails.

Revue automatique

Devin peut examiner automatiquement les pull requests (PR) sans que vous ayez à lancer une revue manuellement. Configurez la revue automatique dans Settings > Review, ou à partir de l’icône des paramètres sur n’importe quelle page de revue de PR.

Quand Auto-Review s’exécute-t-il ?

Auto-Review se déclenche dans les cas suivants :
  • Une pull request (PR) non brouillon est ouverte
  • De nouveaux commits sont poussés sur une PR
  • Une PR en brouillon est marquée comme prête pour revue
  • Un utilisateur inscrit est ajouté comme reviewer ou comme personne assignée à la PR
Les PR en brouillon sont ignorées tant qu’elles ne sont pas marquées comme prêtes pour revue.

Auto-inscription (Tous les utilisateurs)

Tout utilisateur disposant d’un compte GitHub connecté peut s’auto-inscrire aux revues automatiques, sans avoir besoin de droits d’administration.
  1. Accédez à Settings > Review
  2. Cliquez sur “Add myself (@yourusername)” pour vous inscrire
Une fois inscrit, Devin examinera automatiquement toute PR que vous créez, sur laquelle vous êtes ajouté comme reviewer, ou qui vous est assignée, dans n’importe quel dépôt. Vous pouvez aussi vous auto-inscrire directement depuis la page de revue d’une PR en cliquant sur l’icône des paramètres et en activant “Me (@username)”.

Configuration administrateur

Les administrateurs disposent d’options supplémentaires dans Settings > Review :
  • Repositories — Ajoutez des dépôts pour passer en revue automatiquement toutes les pull requests (PR) sur ce dépôt. Utilisez le menu déroulant pour rechercher et sélectionner parmi les dépôts connectés.
  • Users — Affichez et gérez tous les utilisateurs inscrits au sein de l’organisation. Ajoutez n’importe quel nom d’utilisateur GitHub à la liste de revue automatique.
  • Insert link in PR description — Lorsqu’elle est activée (par défaut), Devin ajoute un lien vers la revue dans la description de la PR.
Comptes Enterprise : les paramètres s’appliquent à toutes les organisations de l’Enterprise. Seuls les utilisateurs de l’organisation principale disposant des droits d’administrateur Enterprise peuvent gérer les paramètres. Les utilisateurs des organisations non principales peuvent uniquement s’inscrire eux-mêmes.
La revue automatique n’est pas disponible pour les dépôts publics qui ne sont pas connectés à votre organisation.

Bug Catcher

Le Bug Catcher analyse automatiquement votre pull request (PR) afin de détecter d’éventuels problèmes et affiche les éléments détectés dans la barre latérale Analysis. Ces éléments sont organisés en deux catégories : Bugs et Flags.

Bugs

Les bugs sont des erreurs concrètes qui doivent être corrigées dans le code. Ils représentent des problèmes pour lesquels Bug Catcher a une grande confiance qu’il s’agit bien de véritables anomalies. Les bugs sont affichés avec deux niveaux de sévérité :
  • Grave — Problèmes pour lesquels la confiance est élevée et qui nécessitent une attention immédiate
  • Non grave — Problèmes de sévérité moindre qui doivent tout de même être examinés
Lorsque vous rencontrez un bug, vous devez l’analyser et le corriger dans votre code.

Indicateurs

Les indicateurs sont des annotations de code informatives qui peuvent ou non nécessiter une action. Ils se répartissent en deux catégories :
  • À examiner — Le Bug Catcher a identifié quelque chose qui mérite votre attention. Vous devez examiner vous-même le code signalé et vérifier s’il y a réellement un bug ou un problème.
  • Information — Le Bug Catcher a soit conclu que le code est correct, soit explique le fonctionnement de quelque chose. Ces éléments vous aident à comprendre les changements de code sans nécessiter d’action de votre part.

Résolution des anomalies

Vous pouvez marquer les bogues et les indicateurs comme résolus une fois que vous les avez traités ou déterminé qu’ils ne nécessitent aucune action. Les éléments résolus apparaissent en atténué dans la barre latérale et sont placés en bas de chaque section.

Actions de revue

Commencer une revue

Lorsque vous créez un nouveau commentaire en ligne ou que vous répondez à un fil existant, vous pouvez cocher la case Start a review pour regrouper vos commentaires dans une revue en attente plutôt que de les publier individuellement. Cela reproduit le workflow de revue de GitHub et vous permet de rassembler tous vos retours avant de les soumettre. Une fois qu’une revue est en cours, les commentaires ultérieurs y sont automatiquement ajoutés et la case à cocher est masquée.

Résolution des commentaires

Vous pouvez résoudre des fils de discussion de revue pour indiquer qu’ils ont été traités. Lorsque tous les fils d’une revue rédigée par un bot sont résolus, Devin réduit automatiquement cette revue sur GitHub afin de garder les échanges sur la PR clairs. Si un fil est ultérieurement rouvert, la revue est automatiquement réaffichée. Dans la vue diff, vous pouvez développer ou réduire des fils de commentaires individuels à l’aide de l’icône en forme de chevron pour vous concentrer sur les retours en attente.

Indicateurs de propriétaire du code

Lorsqu’un propriétaire du code a été sollicité en tant que relecteur, Devin Review affiche une icône de bouclier à côté de son nom dans la barre latérale des relecteurs, avec une infobulle « Requested as code owner ». Cela permet d’identifier facilement quels relecteurs en attente sont propriétaires du code des fichiers modifiés.

Auto-Fix

Devin Review peut automatiquement suggérer et appliquer des correctifs pour les bogues qu’il détecte dans vos demandes de fusion (pull requests, PR). Lorsque la fonctionnalité Auto-Fix est activée, Devin proposera des modifications de code directement en regard des bogues qu’il a identifiés.

Comment l’activer

Il existe trois façons d’activer Auto-Fix :
  1. Depuis le popover des paramètres de revue de PR — Sur n’importe quelle page Devin Review, cliquez sur l’icône des paramètres (trois points) et activez Enable Autofix. Ce bouton apparaît pour les PR créées par Devin.
  2. Depuis les paramètres intégrés de la revue de PR — Dans la vue Devin Review intégrée à l’intérieur d’une session Devin, ouvrez le popover des paramètres et activez Enable Autofix.
  3. Depuis les paramètres globaux de Customization — Accédez à Settings > Customization > Pull request settings > Autofix settings - bot comments, puis :
    • Définissez le mode sur Respond to specific bots only et ajoutez devin-ai-integration[bot] à la liste d’autorisation, ou
    • Définissez le mode sur Respond to all bot comments.
Lorsque Devin Review détecte des bogues et qu’Auto-Fix est activé, il génère des correctifs proposés que vous pouvez examiner et appliquer directement depuis la vue du diff.

Autorisations & Contraintes

  • Seuls les administrateurs de l’organisation peuvent modifier ce paramètre.
  • Si le mode de commentaire du bot est défini sur Respond to all bot comments, la bascule Auto-Fix apparaît comme activée mais ne peut pas être modifiée depuis les paramètres de revue de PR. Utilisez les paramètres de Customization pour modifier le mode de commentaire du bot.
  • 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 les commentaires de Devin Review sont actuellement ignorés dans votre dépôt, un message s’affichera dans la chronologie de la session pour vous proposer de les activer.

CLI

La CLI Devin Review vous permet d’effectuer des revues de code directement depuis votre terminal. Elle est particulièrement utile pour les dépôts privés ou lorsque vous souhaitez un flux de travail local simplifié.

Installation & utilisation

Exécutez le CLI à partir d’un clone local du dépôt : aucune authentification n’est requise.
cd path/to/repo
npx devin-review https://github.com/owner/repo/pull/123
Vous devez exécuter cette commande dans le dépôt en cours de revue. Fonctionnement :
  1. Extraction du diff basée sur Git — La CLI utilise votre accès Git local pour récupérer la branche du PR et calculer le diff. Vous devez donc disposer d’un accès en lecture au dépôt sur votre machine.
  2. Checkout dans une arborescence de travail isolée — La CLI crée un git worktree dans un répertoire de cache pour y extraire la branche du PR. Cela laisse votre répertoire de travail intact — pas de stash, pas de changement de branche. L’arborescence de travail est automatiquement nettoyée une fois la revue terminée.
  3. Diff envoyé aux serveurs de Devin — Le diff calculé et le contenu des fichiers sont envoyés aux serveurs de Devin pour analyse.

Confidentialité et contrôle d’accès

La CLI utilise un serveur localhost pour authentifier votre session de revue :
  • Accès local uniquement par défaut — Lorsque vous exécutez devin-review, il démarre un serveur localhost sur votre machine qui fournit un jeton sécurisé. Seuls les processus sur votre machine locale peuvent accéder à ce jeton, ce qui signifie que vous seul pouvez voir la page de revue lorsque vous n’êtes pas connecté.
  • Transfert vers votre compte Devin — Si vous vous connectez à un compte Devin qui a accès à l’organisation GitHub, la session de revue est transférée vers votre compte. Cela vous permet d’accéder à la revue depuis d’autres appareils et de la partager avec vos coéquipiers.
Lorsque vous exécutez la CLI, devin-review peut exécuter des commandes localement sur votre machine pour collecter davantage de contexte et faciliter la recherche de bugs. Cela permet une analyse plus approfondie qu’une revue limitée au diff. Le Bug Catcher peut exécuter un ensemble limité d’opérations en lecture seule, limité au répertoire de la worktree :
  • Lecture de fichiers — Lire le contenu des fichiers au sein du dépôt
  • Recherche — Effectuer des recherches grep pour des motifs et des glob pour des noms de fichiers
  • Commandes Bash — Uniquement des commandes en lecture seule comme ls, cat, pwd, file, head, tail, wc, find, tree, stat et du

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. Lorsqu’un utilisateur clique sur « Apply suggestion », le commit est attribué à cet utilisateur, de la même manière que sur GitHub.
  • 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.

AGENTS.md / Fichiers d’instructions

Devin Review prend en compte les fichiers d’instructions présents dans votre dépôt. Si l’un de ces fichiers est présent, il sera utilisé comme contexte lors de l’analyse de votre PR (pull request) :
  • REVIEW.md
  • AGENTS.md
  • CLAUDE.md
  • CONTRIBUTING.md
  • .cursorrules
  • .windsurfrules
  • .cursor/rules
  • *.rules
  • *.mdc
Ces fichiers peuvent contenir des normes de codage, des conventions de projet ou d’autres directives qui contribuent à fournir des commentaires plus pertinents.

Règles de revue personnalisées

Vous pouvez configurer des fichiers supplémentaires à ingérer comme contexte de revue depuis Settings > Review, dans la section Review Rules. Cela vous permet d’ajouter des motifs glob personnalisés pour les fichiers, au‑delà des valeurs par défaut listées ci‑dessus. Pour ajouter une règle personnalisée :
  1. Allez dans Settings > Review
  2. Sous Review Rules, saisissez un motif glob de fichier (par ex. docs/**/*.md)
  3. Cliquez sur Add
Les règles personnalisées apparaissent dans la liste aux côtés de la règle par défaut **/REVIEW.md. Vous pouvez supprimer n’importe quelle règle personnalisée en cliquant sur l’icône de corbeille située à côté. Cela est utile lorsque votre projet contient une documentation pertinente pour la revue à des emplacements non standard, comme des dossiers de décisions d’architecture, des guides de style ou des conventions propres à une équipe stockées dans des chemins personnalisés.

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 :
# Review Guidelines

## Critical Areas
- All changes to `src/auth/` must be reviewed for security implications.
- Database migration files should be checked for backward compatibility.

## Conventions
- API endpoints must include input validation and proper error handling.
- All public functions require TypeScript return types — do not use `any`.
- React components should use functional components with hooks, not class components.

## Ignore
- Auto-generated files in `src/generated/` do not need review.
- Lock files (package-lock.json, yarn.lock) can be skipped unless dependencies changed.

## Performance
- Flag any database queries inside loops.
- Watch for N+1 query patterns in API resolvers.