Aller au contenu

Examiner votre première demande de tirage

À la fin de ce tutoriel, vous aurez :

  • Ouvert une demande de tirage dans l’aire de travail de PR de Control Center
  • Lu son diff et laissé un commentaire en ligne
  • Soumis un verdict de revue
  • Fusionné la PR

Prérequis : avoir terminé Lancer votre premier agent et avoir une demande de tirage ouverte sur un dépôt enregistré dans cet espace de travail. Pour les étapes de revue, choisissez une PR que vous n’avez pas ouverte — le bouton Revue est masqué sur vos propres PR. La fusion fonctionne quand même sur une PR dont vous êtes l’auteur.

  1. Cliquez sur Demandes de tirage dans la barre latérale
  2. Trouvez votre PR et cliquez dessus

Point de contrôle. La PR s’ouvre comme une aire de travail à onglets — Aperçu, Diff, Contrôle de source, Discussion, Actions — centrée sur Aperçu : le titre et les actions, la description et la chronologie d’activité, et une barre latérale avec l’état, les réviseurs, les personnes assignées, les vérifications et les fichiers modifiés. Cliquer sur un fichier à cet endroit mène directement à ce fichier dans l’onglet Diff. L’onglet Revue ne s’ouvre pas tant que personne ne demande une revue par IA.

Ouvrez l’onglet Diff. Une arborescence de fichiers repliable se trouve à gauche, et la bande au-dessus du diff porte un sélecteur de plage de commits — pour restreindre le diff à un commit ou à une série de commits — ainsi que le nombre de fichiers et le décompte courant d’ajouts et de suppressions.

Le bouton de réglages de la barre d’outils du diff contrôle son rendu :

  • Vue Scindé ou Unifié
  • Retour à la ligne ou défilement des lignes longues
  • Ligatures de la police de code

Marquez un fichier comme vu pour suivre votre progression dans un gros diff. La navigation au clavier est décrite dans Raccourcis clavier.

  1. Survolez une ligne du diff — une petite pastille + apparaît dans la marge
  2. Cliquez dessus pour commenter cette ligne, ou faites-la glisser verticalement d’abord pour sélectionner une plage
  3. Saisissez vos commentaires. Le composeur offre deux envois :
    • Démarrer une revue (ou Ajouter à la revue si une revue est déjà en cours) met le commentaire en file d’attente. Le fil affiche Revue en attente jusqu’à ce que vous soumettiez un verdict à l’étape 4.
    • Ajouter un seul commentaire le publie immédiatement sur GitHub. Le fil affiche Publication…, puis Synchronisé, et propose de réessayer si la publication échoue.

Pour ce tutoriel, utilisez Démarrer une revue afin que le commentaire parte avec le verdict.

  1. Cliquez sur Revue dans la rangée d’actions de l’onglet Aperçu — le même bouton se trouve aussi dans la barre d’outils de l’onglet Diff. Il est masqué sur les PR dont vous êtes l’auteur et sur une PR fermée ou fusionnée.
  2. Rédigez un résumé dans le composeur. Il s’enregistre automatiquement comme brouillon, de sorte que vous pouvez fermer la fenêtre superposée et y revenir.
  3. Choisissez un verdict :
    • Demander des modifications
    • Commenter
    • Approuver

Le verdict est le bouton. Après Approuver ou Demander des modifications, le bouton prend le libellé Approuvé ou Modifications demandées. Un verdict Commenter laisse le bouton sous le libellé Revue.

Point de contrôle. Le bouton affiche « Approuvé » ou « Modifications demandées » si vous avez choisi l’un de ces deux verdicts.

Le bouton Merge est présent dès que GitHub signale que la PR est fusionnable — il n’est pas conditionné à votre propre approbation. Sa couleur indique la préparation plutôt qu’une permission : primaire lorsque les approbations requises et les vérifications sont au vert, secondaire pendant qu’une vérification est en cours, destructive lorsqu’un réviseur sollicité n’a pas approuvé ou qu’une vérification échoue.

  1. Cliquez sur Merge
  2. Choisissez une méthode : Squash and merge, Create a merge commit ou Rebase and merge
  3. Pour les deux premières, modifiez le titre et la description du commit préremplis
  4. Confirmez

Tout problème en suspens — « Échec des vérifications », « Some reviews are pending » — est listé dans le volet volant avant que vous confirmiez.

Après la fusion, un événement de domaine PrMerged est déclenché ; les analyses et les notifications le consomment. Consultez Événements de domaine pour savoir qui d’autre l’écoute.

Control Center peut appliquer un pipeline de réviseurs à une PR ouverte, mais seulement lorsque vous le demandez : le modèle pr_review n’a qu’un déclencheur manuel, rien d’autre.

  1. Ouvrez le menu de débordement de la rangée d’actions de l’onglet Aperçu et choisissez Ask AI. Control Center démarre l’exécution et ouvre l’onglet Revue, pour que vous puissiez regarder les spécialistes travailler.
  2. Les agents réviseurs consignent leurs constats sous forme de nœuds de revue dans l’espace de la PR ; une étape finale les consolide en un seul rapport.

Le pipeline ne publie délibérément rien sur GitHub — il se termine après la consolidation. La publication est une étape distincte que vous faites vous-même, avec le bouton Publier sur GitHub de l’onglet Revue. Consultez Utiliser la révision assistée par IA.

Vous avez ouvert une PR dans l’aire de travail, lu le diff avec la coloration syntaxique, laissé un commentaire en ligne, soumis un verdict et fusionné — sans quitter l’application.

Suivant : Créer votre premier pipeline pour automatiser des workflows à plusieurs étapes.