Utilisation GitHub Copilot révision du code sur GitHub

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.

Demander une révision à partir de Copilot

Sur GitHub.com, créez ou ouvrez une pull request.
Sous « Réviseurs » dans la barre latérale de droite, à côté de Copilot, cliquez sur Demander.
Attendez que Copilot ait terminé l’examen. Cette opération prend généralement moins de 30 secondes.
Lisez les commentaires de Copilot sur la pull request.

Copilot laisse toujours une révision « Commentaire », pas une révision « Approuver » ou « Demander des modifications ». Ses révisions ne comptent pas vers les approbations requises et ne bloquent pas la fusion.

Copilot les commentaires de révision fonctionnent comme ceux des réviseurs humains. Ajoutez des réactions, répondez, résolvez ou masquez-les. Toutes les réponses que vous ajoutez sont visibles pour d’autres personnes, mais pas à Copilot.

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 ».

Utiliser les modifications suggérées

CopilotLes commentaires de l’utilisateur incluent souvent des modifications suggérées que vous pouvez appliquer en quelques clics. Acceptez une suggestion unique ou regroupez plusieurs suggestions en une seule validation. Pour plus d’informations, consultez « Incorporation de commentaires dans votre demande de tirage ».

Pour que Agent cloud Copilot implémente directement les modifications proposées :

Activer GitHub Copilot révision du code et Agent cloud Copilot.
Dans un commentaire de révision de GitHub Copilot révision du code, cliquez sur Corriger avec Copilot. Cela crée un brouillon dans lequel vous demandez Copilot de répondre à des commentaires spécifiques. Vous pouvez choisir si Copilot crée une nouvelle pull request à partir de votre branche ou effectue directement un commit dans la même pull request.

Fournir des commentaires sur les révisions

Évaluez les commentaires de Copilot pour aider à améliorer les suggestions futures.

Sur un commentaire de révision, Copilot, cliquez sur le bouton pouce levé (👍) ou pouce baissé (👎).
Si vous cliquez sur le pouce vers le bas, choisissez éventuellement une raison et laissez un commentaire, puis cliquez sur Soumettre des commentaires.

Demander une nouvelle révision

Lorsque vous envoyez de nouvelles modifications à une pull request qu’a examinée Copilot, elle n’est pas réexaminée automatiquement, sauf si vous avez configuré les revues automatiques pour inclure les nouveaux pushs.

Pour demander manuellement un nouvel examen, 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 des révisions sur chaque envoi push, activez la révision automatique du code et sélectionnez Vérifier les nouveaux envois (push ) dans les paramètres de l’ensemble de règles. Pour plus d’informations, consultez « Configuration de la révision automatique du code par GitHub Copilot ».

Lors de la nouvelle révision, Copilot peut répéter les commentaires précédents, même si vous les avez résolus ou rejetés.

Activer les révisions automatiques

Par défaut, vous demandez des révisions manuellement sur chaque pull request Copilot. Pour activer les révisions automatiques pour toutes les pull requests, consultez Configuration de la révision automatique du code par GitHub Copilot.

Personnaliser les révisions 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 la 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.