Trier votre boîte de réception

Ce guide vous montre comment travailler dans la boîte de réception : la surface unique qui rassemble tout ce qui vous bloque ou vous demande explicitement — les approbations d’agent en attente, les synchronisations de tickets en échec et chaque PR qui vous concerne comme relecteur ou auteur.

Ouvrir la boîte de réception

1. Cliquez sur Boîte de réception dans la barre latérale. Sa pastille compte les approbations d’agent en attente, les synchronisations en échec et les PR ouvertes en attente de votre revue.
2. Ou appuyez sur ⌘K et exécutez la commande de navigation Boîte de réception.
3. Ou accédez directement à /workspaces/<workspace-id>/inbox.

L’entrée de la barre latérale affiche toujours le compte en direct, vous pouvez donc voir le travail de tri s’accumuler sans ouvrir la page.

Lire la gravité d’un coup d’œil

Balayez de haut en bas ; la boîte de réception est déjà classée par ordre d’urgence :

1. Le bandeau épinglé Requiert votre attention se trouve au-dessus des sections de PR. Chaque carte porte une puce de gravité. Les sources enregistrées (un agent coincé sur une invite de confirmation, une synchronisation de tickets dont le miroir du fournisseur est périmé) émettent Bloqué.
2. Dans le bandeau, la gravité la plus urgente passe en premier ; à gravité égale, l’élément qui attend depuis le plus longtemps l’emporte.
3. Sous le bandeau, les PR sont regroupées en sections fixes du cycle de vie de la revue — En attente de votre revue, Renvoyées vers vous, Approuvées, Brouillons, En attente de relecteurs, En cours de fusion et récemment fusionnées, En attente de l’auteur. Les premières sections montrent ce qui vous attend vous ; les autres indiquent où en sont vos PR. En attente de votre revue comprend les PR qui demandent encore une équipe dont vous faites partie, sur les forges qui en ont (GitHub retire l’équipe dès qu’un coéquipier a fait sa revue).

Un élément n’arrive dans la boîte de réception que s’il bloque quelque chose ou s’il vous demande explicitement. Un bandeau vide accompagné d’une liste de sections vide n’affiche Vous êtes à jour que lorsque ce vide est digne de confiance.

Une seule boîte de réception pour toutes les forges

Si l’espace de travail contient des dépôts sur plus d’un hébergeur de code, la boîte de réception les fusionne en un seul flux — une PR GitHub et une PR Bitbucket se trouvent dans la même section, triées par heure plutôt que regroupées par fournisseur. C’est la méta repo #number de la ligne qui permet de les distinguer.

« Vos PR » est résolu par forge, car vous êtes un compte différent sur chacune. Une PR n’est considérée comme la vôtre, ou comme sollicitant votre revue, que lorsqu’elle correspond à votre identité sur la forge où ce dépôt réside réellement.

Une forge hors service ou non connectée n’apporte rien et laisse le reste de la boîte de réception intact — une connexion brisée ne vide jamais toute la liste. L’état vide signale une réserve plutôt que Vous êtes à jour lorsque toutes les connexions de forge sont encore non résolues (Impossible de confirmer votre compte GitHub — le texte mentionne tout de même GitHub), lorsque githubstatus.com signale un incident, ou lorsqu’une installation de GitHub App couvrant des dépôts liés est suspendue.

Vider le bandeau d’attention

Chaque carte du bandeau propose une seule action suivante :

1. Si une carte est une confirmation d’agent en attente, cliquez sur Examiner — vous arrivez dans l’espace de cet agent avec sa confirmation en attente. Approuvez ou refusez sur place (voir Clavarder avec un agent).
2. Si une carte indique Échec de la synchronisation pour un fournisseur, cliquez sur Ouvrir — vous arrivez dans Paramètres → Espace de travail → Général, dont la carte État de la synchronisation montre la dernière synchronisation de chaque connexion, sa série d’échecs consécutifs et son dernier résultat. Seul le dernier échec par fournisseur apparaît dans la boîte de réception, donc une synchronisation rétablie efface la carte.
3. Les cartes disparaissent d’elles-mêmes dès que l’état sous-jacent se règle (l’agent a sa réponse, la synchronisation se rétablit) — il n’y a rien à rejeter manuellement.

Ce sont des confirmations par tour, pas des approbations de gouvernance

Une carte « approbation d’agent » correspond à un agent en cours d’exécution qui s’interrompt pour demander la permission d’une action, dans sa propre conversation. C’est une chose différente de l’enregistrement de gouvernance Approval que les agents créent avec les outils MCP d’approbation — ceux-ci n’ont aucun écran humain nulle part dans l’application et n’apparaissent jamais ici.

L’état de la synchronisation est en lecture seule

La carte rend compte des connexions de synchronisation de tickets ; à part un bouton Synchroniser, elle ne peut ni en créer, ni en modifier, ni en reconnecter une, et aucun autre écran ne le peut non plus. Sans connexion configurée, elle indique simplement « Aucune connexion de synchronisation », ce que montre un espace de travail neuf.

Filtrer sur ce qui bloque

1. Appuyez sur f (quand aucun champ de texte n’a le focus) pour ouvrir le menu de filtres, ou cliquez sur le bouton de filtre dans la barre d’outils.
2. Choisissez n’importe quelle combinaison de statut, d’auteur, de relecteurs, de contenu, de propriétaire ou de nom de dépôt, de fenêtres de dates ou de « rapide à relire ». Les décomptes de facettes du menu indiquent combien d’éléments de la boîte de réception chaque option touche.
3. Les filtres actifs apparaissent sous forme de puces dans la barre au-dessus de la liste ; cliquez sur le ✕ d’une puce pour retirer ce critère.
4. Utilisez le rail de gauche pour sauter entre les sections — chaque entrée affiche son compte en direct et le surlignage suit votre position de défilement. Cliquez sur l’en-tête d’une section pour replier les sections que vous ne triez pas (par exemple Brouillons pendant que vous videz vos revues).
5. Cliquez sur l’en-tête d’une colonne (titre, modifications ou mise à jour) pour trier toutes les sections ; cliquez de nouveau sur la colonne active pour inverser le sens. Le bouton d’options d’affichage contrôle la visibilité des brouillons, la fenêtre des fusions récentes, les propriétés des lignes, le tri et le regroupement (seul le regroupement par auteur change la disposition de la boîte de réception).

Les filtres ici sont indépendants de la file de PR — restreindre la boîte de réception ne change jamais les filtres de la file, et vice versa.

Agir sur un élément de PR

1. Cliquez sur n’importe quelle ligne pour ouvrir la page de détail de la PR.
2. Si la PR se trouve dans En attente de votre revue, examinez-la et soumettez votre décision — voir Examiner et fusionner une PR.
3. Si la PR se trouve dans Renvoyées vers vous (modifications demandées ou échec de la CI), poussez les correctifs depuis votre checkout ou confiez le suivi à un agent.
4. Si la PR se trouve dans Approuvées, fusionnez-la depuis la page de détail.
5. Si vous préférez déléguer une revue plutôt que de la faire vous-même, voir Lancer des agents relecteurs et le cycle de vie du lancement.

Dès que l’état sous-jacent change (votre revue est enregistrée, la PR est fusionnée), le classificateur reclasse automatiquement la PR dans sa nouvelle section.

Annuler une action erronée

1. Appuyez sur ⌘Z pour annuler la dernière action, sur ⌘⇧Z pour la rétablir.
2. Si un champ de texte a le focus, ⌘Z modifie plutôt le texte de ce champ — cliquez à l’extérieur du champ d’abord pour annuler une action au niveau de l’application.

Consulter les raccourcis sur place

Appuyez sur ? (quand aucun champ de texte n’a le focus) pour ouvrir l’aide-mémoire des raccourcis clavier. Il énumère chaque raccourci actif sur la route actuelle, y compris le raccourci de filtre f de la boîte de réception. La carte complète se trouve dans la référence des raccourcis clavier.

La piloter depuis la palette de commandes

1. Appuyez sur ⌘K n’importe où pour ouvrir la palette de commandes.
2. Tapez Boîte de réception pour sauter à la page, ou tapez le titre d’une PR — la palette énumère les PR correspondantes et ouvre celle que vous choisissez.
3. Pendant que la boîte de réception est ouverte, exécutez Copier le lien de cette page pour copier cette URL afin de la partager. La commande copie la route actuelle, ce n’est donc l’URL de la boîte de réception que lorsque vous êtes sur cette page.

Actualiser à la demande

La boîte de réception se met à jour en direct, mais si vous soupçonnez des données périmées, cliquez sur la commande d’actualisation de la barre d’outils — elle force un balayage immédiat côté serveur de chaque forge connectée et récupère de nouveau les superpositions de fusion et de revue. L’icône tourne jusqu’à ce que chaque récupération soit terminée.

Guides connexes

• Examiner et fusionner une PR
• Clavarder avec un agent
• Lancer des agents relecteurs

Concepts connexes

• Cycle de vie du lancement