Skip to main content

Utilisation de GitHub Copilot pour la révision de code

Découvrez comment demander une révision de code à partir de GitHub Copilot.

Introduction

GitHub Copilot peut passer en revue votre code et fournir des commentaires. Le cas échéant, Copilotles commentaires des utilisateurs incluent des modifications suggérées que vous pouvez appliquer en quelques clics.

Pour une introduction complète à GitHub Copilot révision du code, consultez À propos de la révision de code avec GitHub Copilot.

révision du code Copilot est également disponible pour les membres de l’organisation sans Copilot licence, lorsqu’ils sont activés par un administrateur d’entreprise ou un propriétaire de l’organisation. Voir révision du code Copilot pour les membres de l’organisation sans Copilot licence.

Utilisation de révision du code Copilot

Ces instructions expliquent comment utiliser révision du code Copilot dans le GitHub site web. Pour consulter les instructions relatives à d’autres environnements de codage courants, cliquez sur l’onglet approprié en haut de la page.

  1. Sur GitHub.com, créez une pull request ou naviguez vers une pull request existante.

  2. Sous « Réviseurs » dans la barre latérale de droite, à côté de Copilot, cliquez sur Demander.

    Capture d’écran de Copilot avec le bouton « Demander » sous « Réviseurs ».

  3. Attendez que Copilot passe en revue votre demande de fusion. Cette opération prend généralement moins de 30 secondes.

  4. Faites défiler vers le bas et lisez les commentaires de Copilot.

    Capture d'écran d'une revue de code laissée par Copilot.

Copilot laisse toujours une évaluation "Commentaire", pas une évaluation "Approuver" ou une évaluation "Demander des modifications". Cela signifie que les révisions de Copilot ne sont pas prises en compte dans les approbations requises pour la requête de fusion, et que les révisions de Copilot ne bloqueront pas la fusion des modifications. Pour plus d’informations, consultez Approbation d’une demande de tirage comportant des revues obligatoires.

  1. Copilotles commentaires de révision se comportent comme ceux des humains. Vous pouvez y ajouter des réactions, les commenter, les résoudre et les masquer.

    Tous les commentaires que vous ajoutez aux Copilotcommentaires de révision seront visibles par les humains, mais ils ne seront pas visibles par Copilot, et Copilot ne répondront pas.

Vous pouvez également demander une révision Copilot via l’API GitHub REST en demandant copilot-pull-request-reviewer[bot] en tant que réviseur. Pour plus d’informations, consultez « Points de terminaison d’API REST pour les demandes de révision ».

Activation des révisions automatiques

Par défaut, vous demandez manuellement une révision pour chaque pull request Copilot, comme vous le feriez auprès d'un humain. Toutefois, vous pouvez configurer Copilot pour examiner automatiquement toutes les pull requests. Consultez Configuration de la révision automatique du code par GitHub Copilot.

Travailler avec les modifications suggérées fournies par Copilot

Le cas échéant, Copilotles commentaires des utilisateurs incluent des modifications suggérées que vous pouvez appliquer en quelques clics.

Si vous êtes satisfait des modifications, vous pouvez accepter une suggestion unique de Copilot et la valider, ou accepter plusieurs suggestions en bloc dans une seule validation. Pour plus d’informations, consultez « Incorporation de commentaires dans votre demande de tirage ».

Vous pouvez également appeler Agent cloud Copilot pour implémenter des modifications suggérées. Pour ce faire, vous devez :

  • Activer GitHub Copilot révision du code et Agent cloud Copilot.
  • Dans les commentaires de révision de GitHub Copilot révision du code, cliquez sur Corriger avec Copilot. Cela crée un brouillon de commentaire sur le pull request, où vous pouvez demander à Copilot de répondre à des commentaires spécifiques. Vous pouvez ensuite choisir si Copilot créera une nouvelle pull request à partir de votre branche ou un commit dans la même pull request, avec les suggestions appliquées.

Demande d’une nouvelle révision à partir de Copilot

Lorsque vous envoyez des modifications vers une pull request que Copilot a examinée, il ne relira pas automatiquement vos modifications, sauf si vous l’avez configuré pour examiner les nouveaux envois après avoir activé les revues automatiques.

Pour demander manuellement un nouvel examen de la part de Copilot, cliquez sur le bouton à côté du nom de Copilot dans le menu Réviseurs. Pour plus d’informations, consultez « Demande d’examen de requête pull ».

Pour demander automatiquement de nouvelles révisions de la part de Copilot à chaque push, activez la revue automatique du code pour le référentiel et sélectionnez Examiner les nouveaux pushs dans les paramètres du jeu de règles. Pour plus d’informations, consultez « Configuration de la révision automatique du code par GitHub Copilot ».

Remarque

Lors de la révision d'une pull request, Copilot les mêmes commentaires peuvent être répétés, même s’ils ont été rejetés avec le bouton « Résoudre la conversation » ou avec un vote négatif en utilisant le bouton pouces vers le bas (👎).

Personnalisation des Copilot revues avec des instructions personnalisées

Vous pouvez personnaliser révision du code Copilot en ajoutant des instructions personnalisées à votre référentiel.

Les instructions personnalisées du référentiel peuvent s’appliquer à l’ensemble du référentiel ou à un chemin spécifique. Vous spécifiez les instructions personnalisées à l’échelle du référentiel dans un fichier .github/copilot-instructions.md de votre référentiel. Vous pouvez utiliser ce fichier pour stocker les informations que vous souhaitez que Copilot prennent en compte lors de la revue de code n'importe où dans le référentiel.

Vous pouvez également rédiger des instructions que Copilot n'utilisera que lors de la révision de code dans les fichiers correspondant à un chemin d'accès spécifié. Vous rédigez ces instructions dans un ou plusieurs fichiers .github/instructions/**/*.instructions.md.

Pour plus d’informations, consultez « Ajout d’instructions personnalisées de référentiel pour GitHub Copilot ».

Remarque

Lors de l’examen d’une demande de tirage, Copilot utilise les instructions personnalisées dans la branche de base de la demande de tirage. Par exemple, si votre demande de tirage cherche à fusionner my-feature-branch dans main, Copilot va utiliser les instructions personnalisées dans main.

Exemple

Cet exemple de fichier .github/copilot-instructions.md contient trois instructions qui seront appliquées à toutes les révision du code Copilots du référentiel.

When performing a code review, respond in Spanish.

When performing a code review, apply the checks in the `/security/security-checklist.md` file.

When performing a code review, focus on readability and avoid nested ternary operators.

Les serveurs MCP et les compétences de l’agent

Remarque

Support for agent skills and MCP servers with révision du code Copilot is in préversion publique and subject to change.

révision du code Copilot peut utiliser les compétences de l’agent et les serveurs MCP configurés dans le référentiel, lorsqu’ils sont pertinents pour le code en cours de révision.

Pour les rendre disponibles pour révision du code Copilot sur GitHub, configurez :

  • Compétences de l’agent dans votre référentiel (en .github/skills). Si vous souhaitez qu’une compétence cible les tâches de révision, utilisez un nom de répertoire de compétences axé sur la révision, tel que code-review. Pour plus d’informations sur l’installation, consultez Ajout des compétences des agents pour GitHub Copilot.
  • Serveurs MCP dans les paramètres de Copilot du référentiel. Le serveur MCP GitHub et le serveur MCP Playwright sont activés par défaut. Pour plus d’informations sur l’installation, consultez Configurer des serveurs MCP pour votre référentiel.

révision du code Copilot est plus susceptible d’utiliser ce contexte lorsque :

  • Les répertoires de compétences de l’agent ont des noms et des descriptions liés à la révision, tels que code-review, ce qui indique qu’ils sont destinés à la révision des pull requests.
  • Vos compétences de l’agent ou des instructions personnalisées indiquent révision du code Copilot explicitement d’utiliser un contexte MCP spécifique.
  • Les descriptions des pull requests font référence à des éléments disponibles sur les serveurs MCP configurés, tels que des clés de ticket ou des ID d’incident.

Pour vérifier quel contexte MCP révision du code Copilot a été utilisé pour une révision donnée, ouvrez la session de révision liée depuis la chronologie de la pull request, puis consultez les journaux de session pour voir quels serveurs MCP et outils ont été appelés.

Dans les paramètres du référentiel, Autoriser Copilot à utiliser les outils MCP lors de l’examen des pull requests est activé par défaut. Désactivez ce paramètre si vous souhaitez que les serveurs MCP soient disponibles uniquement pour Agent cloud Copilot, et non pour révision du code Copilot. Pour obtenir des instructions pas à pas, consultez Configurer des serveurs MCP pour votre référentiel.

Fournir des commentaires sur Copilotles révisions

Vous pouvez répondre aux commentaires de Copilot dans chaque commentaire. Nous utilisons ces informations pour améliorer le produit et la qualité des Copilotsuggestions.

Pour donner votre avis sur un commentaire de révision de Copilot, cliquez sur le bouton pouce levé (👍) ou pouce baissé (👎).

Capture d'écran montrant un commentaire révision du code Copilot avec les boutons « pouce levé » et « pouce baissé ».

Examen d'une sélection de codes

Vous pouvez demander une révision initiale d’une sélection de code mise en surbrillance dans Visual Studio Code.

  1. Dans Visual Studio Code, sélectionnez le code que vous souhaitez examiner.
  2. Cliquez avec le bouton droit sur le code sélectionné et choisissez Générer larévision > ****.
  3. VS Code crée des commentaires de révision dans le panneau Commentaires et les affiche également inline dans l’éditeur.

Révision de toutes les modifications non validées

Vous pouvez demander une révision de vos modifications non validées dans Visual Studio Code.

  1. Dans VS Code, cliquez sur le bouton Contrôle de code source dans la barre d’activité.

  2. En haut de la vue Contrôle de code source, pointez sur MODIFICATIONS, puis cliquez sur le Copilot bouton Révision du code - Modifications non validées .

    Capture d’écran de la vue « Contrôle de code source ». Le bouton d'examen du code est souligné en orange foncé.

  3. Attendez qu'Copilot passe en revue vos modifications. Cette opération prend généralement moins de 30 secondes.

  4. Si Copilot a des commentaires, ils s'afficheront dans vos fichiers et dans l'onglet Problèmes.

Travailler avec les modifications suggérées fournies par Copilot

Si possible, Copilotles commentaires des utilisateurs incluent des modifications suggérées que vous pouvez appliquer en un seul clic.

Capture d'écran d'un commentaire de Copilot dans Visual Studio Code avec une suggestion de modification.

Si vous êtes satisfait de la modification, vous pouvez accepter une suggestion de Copilot en cliquant sur le bouton Appliquer et Atteindre Suivant. Les modifications que vous appliquerez ne seront pas automatiquement validées.

Si vous ne souhaitez pas appliquer Copilotla modification suggérée, cliquez sur le bouton Ignorer et Accéder au bouton Suivant .

Fournir des commentaires sur Copilotles révisions

Vous pouvez répondre aux commentaires de Copilot dans chaque commentaire. Nous utilisons ces informations pour améliorer le produit et la qualité des Copilotsuggestions.

Pour fournir des commentaires, pointez sur le commentaire et cliquez sur le bouton haut ou bas.

Capture d'écran d'un commentaire de Copilot dans Visual Studio Code avec les boutons de feedback affichés. Les boutons sont encadrés en orange foncé.

Personnalisation des Copilot revues avec des instructions personnalisées

Vous pouvez personnaliser révision du code Copilot en ajoutant des instructions personnalisées à votre référentiel.

Les instructions personnalisées du référentiel peuvent s’appliquer à l’ensemble du référentiel ou à un chemin spécifique. Vous spécifiez les instructions personnalisées à l’échelle du référentiel dans un fichier .github/copilot-instructions.md de votre référentiel. Vous pouvez utiliser ce fichier pour stocker les informations que vous souhaitez que Copilot prennent en compte lors de la revue de code n'importe où dans le référentiel.

Vous pouvez également rédiger des instructions que Copilot n'utilisera que lors de la révision de code dans les fichiers correspondant à un chemin d'accès spécifié. Vous rédigez ces instructions dans un ou plusieurs fichiers .github/instructions/**/*.instructions.md.

Pour plus d’informations, consultez « Ajout d’instructions personnalisées de référentiel pour GitHub Copilot ».

Remarque

Lors de l’examen d’une demande de tirage, Copilot utilise les instructions personnalisées dans la branche de base de la demande de tirage. Par exemple, si votre demande de tirage cherche à fusionner my-feature-branch dans main, Copilot va utiliser les instructions personnalisées dans main.

Exemple

Cet exemple de fichier .github/copilot-instructions.md contient trois instructions qui seront appliquées à toutes les révision du code Copilots du référentiel.

When performing a code review, respond in Spanish.

When performing a code review, apply the checks in the `/security/security-checklist.md` file.

When performing a code review, focus on readability and avoid nested ternary operators.

Prérequis

Pour l’utiliser révision du code Copilot, vous devez utiliser Visual Studio la version 17.14 ou ultérieure. Consultez la Visual Studio page des téléchargements.

Utilisation de révision du code Copilot

Ces instructions expliquent comment utiliser révision du code Copilot dans Visual Studio. Pour consulter les instructions relatives à d’autres environnements de codage courants, cliquez sur l’onglet approprié en haut de la page.

  1. Dans la fenêtre Modifications Git, cliquez sur Vérifier les modifications avec Copilot. Ce bouton apparaît sous la forme d’une icône de commentaire avec une étincelle.

  2. Copilot commencera à examiner vos modifications. Après quelques instants, un lien indiquant le nombre de commentaires de revue apparaît dans la fenêtre Modifications Git.

  3. Cliquez sur le lien pour afficher et parcourir les commentaires. Si aucun problème n’est détecté, le message s’affiche : Copilot n’a pas commenté les fichiers.

  4. Copilot affiche des commentaires dans votre code avec un résumé de chaque problème potentiel. Vous pouvez :

    • Passez en revue les suggestions et apportez les modifications nécessaires.
    • Masquez un commentaire en cliquant sur la flèche vers le bas dans le coin supérieur droit de la zone de commentaire.
  5. Pour supprimer tous les commentaires de révision, cliquez sur à côté du lien de révision de code dans la fenêtre Modifications Git.

Pour plus d’informations sur l’activation et la configuration révision du code Copilot dans Visual Studio, consultez Examiner les modifications locales avec Discussion avec Copilot dans la documentation Visual Studio.

Utilisation de révision du code Copilot

Ces instructions expliquent comment utiliser révision du code Copilot dans GitHub Mobile. Pour consulter les instructions relatives à d’autres environnements de codage courants, cliquez sur l’onglet approprié en haut de la page.

  1. Dans GitHub Mobile, ouvrez une pull request.
  2. Faites défiler jusqu’à la section Révisions et développez-la.
  3. Cliquez sur Demander des avis.
  4. Ajoutez Copilot en tant que réviseur, puis cliquez sur Terminé.

Copilot passe en revue les modifications et fournit des commentaires.

Prérequis

Pour l’utiliser révision du code Copilot dans Xcode, vous devez utiliser la version 0.41.0 ou ultérieure de l’extension GitHub Copilot Chat . Téléchargez la dernière version à partir du dépôt github/CopilotForXcode.

Utilisation de révision du code Copilot

Ces instructions expliquent comment utiliser révision du code Copilot dans Xcode. Pour consulter les instructions relatives à d’autres environnements de codage courants, cliquez sur l’onglet approprié en haut de la page.

  1. Dans Xcode, apportez des modifications à un ou plusieurs fichiers.

  2. Ouvrez la Copilot fenêtre de conversation en cliquant sur Éditeur dans la barre de menus, puis sur GitHub Copilot****Ouvrir la conversation.

  3. En bas à droite de la zone d’invite dans la Copilot fenêtre de conversation, cliquez sur le bouton Révision du code (icône de bulle vocale).

    Capture d’écran de la fenêtre de conversation Copilot dans Xcode, avec le bouton « Révision de code » surligné en orange foncé.

  4. Cliquez sur Réviser les modifications préparées, ou sur Réviser les modifications non préparées.

  5. Une liste des fichiers contenant des modifications s’affiche dans la fenêtre de conversation. Cliquez sur les cases à cocher pour désélectionner les fichiers que vous ne souhaitez Copilot pas examiner.

  6. Cliquez sur Continuer pour lancer le processus de revue.

  7. Si Copilot trouve des éléments à commenter, il affiche une liste des modifications examinées dans la fenêtre de conversation, en répertoriant les fichiers sur lesquels il a commenté. Cliquez sur un fichier dans cette liste pour voir les commentaires.

    Chaque commentaire s’affiche dans une fenêtre contextuelle, superposée à l’éditeur.

    Capture d’écran d’un commentaire de review révision du code Copilot.

  8. S’il y a plusieurs commentaires dans le fichier, utilisez les flèches haut et bas, en haut à droite de la fenêtre contextuelle, pour naviguer entre les commentaires.

  9. Copilot peut suggérer du code de remplacement. Vous pouvez appliquer la modification suggérée en cliquant sur Accepter ou la rejeter en cliquant sur Ignorer.

  10. Cliquez sur un autre fichier dans la liste Modifications révisées de la fenêtre de conversation pour afficher les commentaires de revue d’un autre fichier.

Prérequis

Utilisation de révision du code Copilot

Ces instructions expliquent comment utiliser révision du code Copilot dans les IDE JetBrains. Pour consulter les instructions relatives à d’autres environnements de codage courants, cliquez sur l’onglet approprié en haut de la page.

  1. Dans un IDE JetBrains, apportez des modifications à un ou plusieurs fichiers.

  2. Ouvrez la fenêtre « Commit » sur la gauche.

  3. Au-dessus du champ d’entrée de message de validation, cliquez sur Copilot : Passer en revue les modifications du code. Ce bouton apparaît sous la forme d'une icône représentant une loupe avec une étincelle.

  4. Copilot commencera à examiner vos modifications.

  5. Copilot affiche des commentaires dans votre code avec un résumé de chaque problème potentiel. Vous pouvez :

    • Passez en revue les suggestions et apportez les modifications nécessaires.
    • Ignorez un commentaire en cliquant sur Ignorer.
  6. S'il y a plusieurs commentaires, utilisez les flèches haut et bas situées en haut à droite de la fenêtre contextuelle pour naviguer entre les commentaires.

Prérequis

Utilisation de révision du code Copilot

Ces instructions expliquent comment utiliser révision du code Copilot avec le GitHub CLI. Pour consulter les instructions relatives à d’autres environnements de codage courants, cliquez sur l’onglet approprié en haut de la page.

Demande d’une révision lors de la création d’un pull request

Vous pouvez demander une révision lorsque vous créez une nouvelle pull request à l'aide de Copilotgh pr create :

Shell
gh pr create --reviewer @copilot

Vous pouvez également sélectionner Copilot de manière interactive à partir de l’invite de réviseur pouvant faire l’objet d’une recherche pendant gh pr create.

? Reviewers  [Use arrows to move, space to select, <right> to all, <left> to none, type to filter]
  [ ]  Search (7472 more)
  [x]  monalisa (Mona Lisa)
> [x]  Copilot (AI)

Demande de révision sur une pull request existante

Pour demander une révision de Copilot Copilot sur une pull request existante, utilisez gh pr edit. Si vous n’êtes pas sur la branche du pull request, spécifiez le numéro de pull request :

Shell
gh pr edit PR-NUMBER --add-reviewer @copilot

Remplacez PR-NUMBER par le numéro de la pull request que vous souhaitez examiner. Si vous avez extrait la branche de la pull request, vous pouvez omettre le numéro.