Salta ai contenuti

Gestisci la posta in arrivo

Questa guida mostra come usare la posta in arrivo: l’unica superficie che raccoglie tutto ciò che ti blocca o richiede esplicitamente il tuo intervento — approvazioni degli agenti in sospeso, sincronizzazioni dei ticket non riuscite e ogni pull request che ti coinvolge come revisore o autore.

  1. Clicca Posta in arrivo nella barra laterale. Il suo badge conta le approvazioni degli agenti in sospeso, le sincronizzazioni non riuscite e le PR aperte in attesa della tua revisione.
  2. Oppure premi ⌘K ed esegui il comando di navigazione Posta in arrivo.
  3. Oppure usa un deep link diretto a /workspaces/<workspace-id>/inbox.

La voce della barra laterale mostra sempre il conteggio in tempo reale, così puoi vedere il lavoro di triage accumularsi senza aprire la pagina.

Scorri dall’alto verso il basso; la posta in arrivo è già ordinata per urgenza:

  1. La striscia fissata Richiede la tua attenzione si trova sopra le sezioni delle PR. Ogni scheda riporta un chip di gravità. Le origini registrate (un agente bloccato su un prompt di conferma, una sincronizzazione dei ticket la cui copia del fornitore è obsoleta) emettono Bloccato.
  2. All’interno della striscia, la gravità più urgente viene per prima; in caso di parità vince la voce in attesa da più tempo.
  3. Sotto la striscia, le PR sono raggruppate in sezioni fisse del ciclo di vita della revisione — In attesa della tua revisione, Restituite a te, Approvate, Bozze, In attesa di revisori, In fusione e unite di recente, In attesa dell’autore. Le sezioni in alto sono ciò che serve a te; le altre indicano dove si trovano le tue PR. In attesa della tua revisione include le PR che richiedono ancora un team a cui appartieni, sugli host di codice che li supportano (GitHub rimuove il team non appena un compagno di squadra revisiona).

Una voce finisce nella posta in arrivo solo quando blocca qualcosa o ti richiede esplicitamente. Una striscia vuota insieme a un elenco di sezioni vuoto mostra Sei in pari solo quando quel vuoto è attendibile.

Se lo spazio di lavoro contiene repository su più di un host di codice, la posta in arrivo le unisce in un unico flusso: una pull request di GitHub e una di Bitbucket stanno nella stessa sezione, ordinate per data anziché raggruppate per fornitore. È il meta repo #number della riga a distinguerle.

Il concetto di “tue” viene risolto per singolo host di codice, perché su ciascuno sei un account diverso. Una pull request è considerata tua, o come richiedente la tua revisione, solo quando corrisponde alla tua identità sull’host di codice in cui la repository risiede davvero.

Un host di codice non raggiungibile o non collegato non contribuisce in alcun modo e lascia intatto il resto della posta in arrivo: una connessione interrotta non svuota mai l’intero elenco. Lo stato vuoto segnala un’avvertenza anziché Sei in pari quando ogni accesso agli host di codice è ancora irrisolto (Impossibile confermare il tuo account GitHub: il testo nomina comunque GitHub), quando githubstatus.com segnala un incidente o quando un’installazione della GitHub App che copre repository collegate è sospesa.

Ogni scheda della striscia ha una sola azione successiva:

  1. Se una scheda è una conferma di agente in sospeso, clicca Esamina — ti ritrovi nello spazio di quell’agente con la sua conferma in sospeso. Approva o rifiuta lì (vedi Chatta con un agente).
  2. Se una scheda segnala Sincronizzazione non riuscita per un fornitore, clicca Apri — arrivi a Impostazioni → Spazio di lavoro → Generale, la cui scheda Stato sincronizzazione mostra l’ultima sincronizzazione di ogni connessione, la serie di errori consecutivi e l’esito più recente. Nella posta in arrivo compare solo l’errore più recente per fornitore, quindi una sincronizzazione ripristinata cancella la scheda.
  3. Le schede scompaiono da sole quando lo stato sottostante si risolve (l’agente riceve una risposta, la sincronizzazione si ripristina) — non c’è nulla da chiudere manualmente.
  1. Premi f (con nessun campo di testo attivo) per aprire il menu dei filtri, oppure clicca il pulsante dei filtri nella barra degli strumenti.
  2. Scegli qualsiasi combinazione di stato, autore, revisori, contenuto, proprietario/nome della repository, intervalli di date o rapida da revisionare. I conteggi dei facet nel menu mostrano a quante voci della posta in arrivo corrisponde ogni opzione.
  3. I filtri attivi compaiono come chip nella barra sopra l’elenco; clicca la ✕ di un chip per rimuovere quel criterio.
  4. Usa la barra laterale sinistra per saltare da una sezione all’altra — ogni voce mostra il conteggio in tempo reale e l’evidenziazione segue la posizione di scorrimento. Clicca l’intestazione di una sezione per comprimere le sezioni che non gestisci (ad esempio Bozze mentre smaltisci le revisioni).
  5. Clicca l’intestazione di una colonna (titolo, modifiche o aggiornato) per ordinare tutte le sezioni; clicca di nuovo la colonna attiva per invertire il verso. Il pulsante delle opzioni di visualizzazione controlla la visibilità delle bozze, la finestra delle PR unite di recente, le proprietà delle righe, l’ordinamento e il raggruppamento (solo il raggruppamento per autore cambia il layout della posta in arrivo).

I filtri qui sono indipendenti dalla coda delle PR — restringere la posta in arrivo non cambia mai i filtri della coda e viceversa.

  1. Clicca una riga qualsiasi per aprire la pagina di dettaglio della PR.
  2. Se la PR è in In attesa della tua revisione, esaminala e invia la tua decisione — vedi Revisiona e unisci una PR.
  3. Se la PR è in Restituite a te (modifiche richieste o CI non riuscita), invia le correzioni dal tuo checkout o affida il seguito a un agente.
  4. Se la PR è in Approvate, uniscila dalla pagina di dettaglio.
  5. Se preferisci delegare una revisione invece di farla tu, vedi Invia agenti revisori e il ciclo di vita dell’invio.

Quando lo stato sottostante cambia (la tua revisione viene registrata, la PR viene unita), il classificatore ricolloca automaticamente la PR nella sua nuova sezione.

  1. Premi ⌘Z per annullare l’ultima azione, ⌘⇧Z per ripeterla.
  2. Se è attivo un campo di testo, ⌘Z modifica invece il testo del campo — clicca fuori dal campo per annullare un’azione a livello di app.

Premi ? (con nessun campo di testo attivo) per aprire il riepilogo delle scorciatoie da tastiera. Elenca ogni associazione attiva nella route corrente, inclusa la scorciatoia f dei filtri della posta in arrivo. La mappa completa è nel riferimento delle scorciatoie da tastiera.

  1. Premi ⌘K in qualsiasi punto per aprire la palette dei comandi.
  2. Digita Posta in arrivo per saltare alla pagina, oppure digita il titolo di una PR — la palette elenca le pull request corrispondenti e apre quella che scegli.
  3. Mentre la posta in arrivo è aperta, esegui Copia il link di questa pagina per copiare quell’URL e condividerlo. Il comando copia la route corrente, quindi è l’URL della posta in arrivo solo quando ti trovi su questa pagina.

La posta in arrivo si aggiorna in tempo reale, ma se sospetti dati obsoleti, clicca il controllo di aggiornamento nella barra degli strumenti — forza una scansione immediata lato server di ogni host di codice collegato e riscarica gli overlay relativi a unioni e revisioni. L’icona gira finché ogni richiesta non si conclude.