Utiliser la revue de code GitHub Copilot

Utilisation de Révision du code Copilot

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

1. Dans GitHub.com, créez une demande de tirage ou accédez à une demande de tirage existante.

2. Ouvrez le menu Réviseurs, puis sélectionnez Copilot.

   

3. Attendez que Copilot examine votre demande de tirage. Cette opération prend généralement moins de 30 secondes.

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

   

   Copilot laisse toujours un avis « Commentaire », et non un avis « Approuver » ou « Demander des modifications ». Cela signifie que les révisions de Copilot ne comptent pas dans les approbations requises pour la demande de tirage, 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.

5. Les commentaires de révision de Copilot se comportent comme des commentaires humains. Vous pouvez y ajouter des réactions, les commenter, les résoudre et les masquer.

   Tous les commentaires que vous ajoutez à Copilotseront visibles par les humains, mais ils ne seront pas visibles par Copilot, et Copilot ne répondront pas.

Travailler avec les changements suggérés par Copilot

Dans la mesures du possible, les commentaires de Copilot comprennent des suggestions de modifications que vous pouvez appliquer en quelques clics.

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

Fournir un retour d'information sur les commentaires de Copilot.

Vous pouvez donner votre avis sur les commentaires de Copilot directement dans chaque commentaire. Nous utilisons ces informations pour améliorer le produit et la qualité des suggestions de Copilot.

1. Sur un commentaire de révision de demande de tirage provenant de Copilot, cliquez sur le bouton pouce vers le haut (:+1 :) ou vers le bas (:-1 :).

   

2. Si vous cliquez sur le bouton « pouce vers le bas », vous êtes invité à fournir des informations supplémentaires. Vous pouvez, si vous le souhaitez, choisir la raison de vos commentaires négatifs et laisser un commentaire avant de cliquer sur Envoyer des commentaires.

   

Demande de réexamen de Copilot

Lorsque vous apportez des modifications à une demande de tirage que Copilot a examinée, vos modifications ne seront pas automatiquement réexaminées.

Pour demander un nouvel examen à Copilot, cliquez sur le bouton à côté du nom de Copilot dans le menu Réviseurs. Pour plus d’informations, consultez « Demande d’une évaluation de demande de tirage ».

Activation des révisions automatiques

Par défaut, vous demandez manuellement une révision à Copilot pour chaque demande de tirage, comme vous le feriez pour une révision humaine. Toutefois, vous pouvez configurer Copilot pour passer automatiquement en revue toutes les demandes de tirage. Consultez Configuration de la revue automatique du code par GitHub Copilot.

Personnalisation des revues de Copilot grâce à 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 prenne en compte lors de la revue dans n’importe quel emplacement du référentiel.

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

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

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.

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.