Gestion des pull requests avec la commande /pr

Utilisez la commande slash /pr pour afficher, créer et corriger les pull requests directement à partir de Copilot pour CLI.

Dans cet article

Aperçu

La /pr commande slash vous permet de gérer le cycle de vie complet des pull requests sans quitter votre terminal. Vous pouvez vérifier l'état des pull requests, créer de nouvelles pull requests et résoudre les problèmes courants, tels que les retours de révision, les conflits de fusion et les problèmes avec les intégrations CI.

Conditions préalables

Vous devez travailler dans un référentiel Git hébergé sur GitHub.

Sous-commandes

La /pr commande slash comporte plusieurs sous-commandes que vous pouvez utiliser pour réaliser différentes actions sur vos pull requests.

Remarque

Toutes les /pr sous-commandes concernent la branche actuelle, par exemple, en corrigeant les vérifications CI défaillantes pour la pull request associée à la branche actuelle.

Utiliser cette sous-commande Pour ce faire Nécessite une pull request existante Peut valider et envoyer (push)
/pr ou /pr view Affichez l'état du pull request pour la branche courante. En savoir plus Yes No
/pr view web Ouvrez la pull request dans votre navigateur. En savoir plus Yes No
/pr create Créez ou mettez à jour une pull request. En savoir plus No Yes
/pr fix feedback Adressez les commentaires de révision sur la demande de tirage. En savoir plus Yes Yes
/pr fix conflicts Synchronisez la branche avec la branche de base et résolvez les conflits. En savoir plus Yes Yes
/pr fix ci Diagnostiquer et corriger les échecs des vérifications CI. En savoir plus Yes Yes
/pr fix ou /pr fix all Exécutez les trois phases de correctif dans l’ordre : commentaires, conflits, puis CI. En savoir plus Yes Yes
/pr auto Créez une pull request si nécessaire, puis parcourez toutes les phases de correction jusqu’à ce que toutes les vérifications de pull request soient validées. En savoir plus No Yes

Les sous-commandes qui valident et envoient (push) les modifications vous demandent votre autorisation avant d’effectuer des actions potentiellement destructrices, sauf si vous avez prédisposé ces outils. Pour plus d’informations, consultez « Autorisation et refus de l’utilisation de l’outil ».

Consultation de l’état de la demande de fusion

Pour vérifier l’état du pull request associé à votre branche actuelle, entrez ce qui suit dans une session interactive :

Copilot prompt
/pr

Ouverture de la pull request dans votre navigateur

Si vous souhaitez afficher la pull request sur GitHub.com plutôt que dans le terminal, entrez :

Copilot prompt
/pr view web

Cela ouvre l'URL de la pull request dans votre navigateur par défaut.

Création d’une pull request

Pour créer une pull request depuis votre branche actuelle, entrez :

Copilot prompt
/pr create

          Copilot garantit que toutes les validations locales sont envoyées à la branche distante, puis crée la pull request. Si un modèle de pull request existe dans le référentiel, Copilot le suit pour générer le titre et la description de la pull request.

Si un pull request existe déjà pour current Branch, /pr create met à jour le pull request existant au lieu d'en créer un nouveau.

Ajout d’instructions pour la création d’un pull request

Vous pouvez ajouter des instructions après /pr create pour guider Copilot. Par exemple:

Copilot prompt
/pr create prefix the PR title 'Project X: '

Correction des commentaires de révision

Pour que Copilot lise et traite les commentaires de revue sur votre pull request, entrez :

Copilot prompt
/pr fix feedback

          Copilot récupère tous les threads de commentaires de révision sur la pull request, détermine les modifications demandées, applique les modifications à votre codebase et valide et pousse les correctifs. Les demandes de modification de code actionnables sont classées par ordre de priorité par rapport aux commentaires conversationnels.

Résolution des conflits de fusion

Pour synchroniser votre branche avec la branche de base et résoudre les conflits de fusion, entrez :

Copilot prompt
/pr fix conflicts

          Copilot récupère la branche de base la plus récente, synchronise votre branche, résout les conflits et envoie (push) le résultat.

Choix d’une stratégie de fusion

Lors de la résolution des conflits, Copilot pour CLI doit savoir s'il faut utiliser une stratégie de rebase ou de fusion. Si vous n’avez pas configuré de préférence, Copilot vous invite à choisir quand vous exécutez une commande qui implique la résolution des conflits.

Pour définir une stratégie de fusion par défaut afin que vous ne soyez pas invité à chaque fois, ajoutez le mergeStrategy paramètre à votre fichier de configuration. Vous pouvez définir cette valeur dans vos paramètres utilisateur personnels pour Copilot ou dans les paramètres du dépôt.

  • Paramètres utilisateur : ajouter "mergeStrategy": "rebase" ou "mergeStrategy": "merge" à votre fichier de configuration au niveau de l’utilisateur (généralement ~/.copilot/config.json).
  • Paramètres du référentiel : ajoutez les mêmes paramètres à la racine de votre référentiel .github/copilot/settings.json.

Résolution des échecs d’intégration continue

Pour faire diagnostiquer Copilot et corriger les échecs des vérifications de CI, entrez :

Copilot prompt
/pr fix ci

          Copilot identifie les jobs CI défaillants, analyse les logs pour déterminer les causes racines, applique des correctifs ciblés et les pousse. Il vérifie ensuite l'état du CI et répète le processus jusqu'à ce que les vérifications réussissent ou tant qu'il détermine que toute progression supplémentaire est impossible.

Si les échecs ne sont pas liés aux modifications de votre branche, Copilot l'indique clairement afin que vous puissiez agir en conséquence.

Vous pouvez ajouter un contexte supplémentaire pour vous concentrer Copilot sur des échecs spécifiques. Par exemple:

Copilot prompt
/pr fix ci focus on test failures

Résolution de tous les problèmes en même temps

Pour traiter tous les problèmes en suspens sur une pull request dans une seule commande, entrez :

Copilot prompt
/pr fix

Cette opération exécute trois phases dans l’ordre :

  1.        **Commentaires de révision** : répond à tous les commentaires de révision.

  2.        **Conflits** : synchronise la branche avec la branche de base et résout les conflits.

  3.        **Échecs CI** — Diagnostique et corrige les vérifications CI ayant échoué.

Automatisation du workflow complet de pull request

Pour que Copilot gère l'ensemble du processus de pull request, de sa création jusqu'à ce qu'elle soit entièrement validée, entrez :

Copilot prompt
/pr auto

Si aucune pull request n'existe pour la branche actuelle, Copilot en crée d'abord une. Il effectue ensuite une boucle dans les phases de correction (commentaires, conflits et CI) en répétant jusqu’à ce qu’il n’y ait plus de commentaires de révision, aucun conflit et que toutes les vérifications CI passent.

Vous pouvez ajouter des instructions pour guider la création de la pull request. Par exemple:

Copilot prompt
/pr auto include migration notes in the description

Lectures complémentaires