Třídění doručené pošty

Tenhle návod ukazuje, jak pracovat s doručenou poštou: jednou plochou, na které se sejde všechno, co tě blokuje nebo o tebe výslovně žádá — čekající potvrzení agentů, selhané synchronizace ticketů a každý pull request, ve kterém jsi recenzent nebo autor.

Otevři doručenou poštu

1. Klikni na Doručená pošta v postranním panelu. Odznak počítá čekající potvrzení agentů, selhané synchronizace a otevřené PR, které čekají na tvoji kontrolu.
2. Nebo stiskni ⌘K a spusť navigační příkaz Doručená pošta.
3. Nebo otevři přímo /workspaces/<workspace-id>/inbox.

Položka v postranním panelu vždy ukazuje aktuální počet, takže vidíš, jak se práce k třídění hromadí, aniž bys stránku otevřel.

Závažnost na první pohled

Prohlédni ji shora dolů. Doručená pošta je už seřazená podle naléhavosti:

1. Připnutý pruh Vyžaduje vaši pozornost sedí nad sekcemi PR. Každá karta nese štítek závažnosti. Registrované zdroje (agent, který uvízl na výzvě k potvrzení, synchronizace ticketu, jejíž zrcadlo u dodavatele je zastaralé) hlásí Blokováno.
2. Uvnitř pruhu jde nejdřív nejnaléhavější závažnost. Při shodě vyhraje položka, která čeká nejdéle.
3. Pod pruhem jsou PR seskupené do pevných sekcí životního cyklu kontroly — Potřebuje vaši kontrolu, Vráceno vám, Schváleno, Koncepty, Čeká na recenzenty, Slučuje se a nedávno sloučené, Čeká na autora. Horní sekce jsou to, co potřebuje tebe. Zbytek ukazuje, jak na tom jsou tvoje PR. Potřebuje vaši kontrolu zahrnuje i PR, které pořád žádají tým, do kterého patříš, na forge, které týmy mají (GitHub tým odebere, jakmile ho zkontroluje kdokoli z týmu).

Do doručené pošty se položka dostane jen tehdy, když něco blokuje, nebo o tebe výslovně žádá. Prázdný pruh spolu s prázdným seznamem sekcí ukáže Máte všechno přečtené jen tehdy, když se na tu prázdnotu dá spolehnout.

Jedna doručená pošta napříč všemi forge

Když pracovní prostor drží repozitáře na víc než jednom hostiteli kódu, doručená pošta je sloučí do jednoho proudu — pull request z GitHubu a pull request z Bitbucketu sedí ve stejné sekci, seřazené podle času, ne podle dodavatele. Od sebe je odliší meta řádku repo #number.

Co je „tvoje“, se určuje u každé forge, protože na každé jsi jiný účet. Pull request se počítá jako tvůj, nebo jako žádost o tvoji kontrolu, jen když odpovídá tvé identitě na forge, na které ten repozitář opravdu leží.

Forge, která je nedostupná nebo nepřipojená, nepřispěje ničím a zbytek doručené pošty nechá být — jedno rozbité připojení nikdy nevyprázdní celý seznam. Prázdný stav místo Máte všechno přečtené uvede výhradu, když je přihlášení u všech forge pořád nevyřešené (Váš účet GitHub se nepodařilo potvrdit — text pořád jmenuje GitHub), když githubstatus.com hlásí incident, nebo když je pozastavená instalace GitHub App, která pokrývá propojené repozitáře.

Ukliď pruh pozornosti

Každá karta v pruhu má jednu další akci:

1. Když je karta čekající potvrzení agenta, klikni na Kontrola — ocitneš se v prostoru toho agenta u čekajícího potvrzení. Tam ho schval, nebo zamítni (viz Chatujte s agentem).
2. Když karta u dodavatele říká Synchronizace selhala, klikni na Otevřít — ocitneš se v Nastavení → Pracovní prostor → Obecné. Karta Zdraví synchronizace tam ukazuje u každého připojení poslední synchronizaci, sérii po sobě jdoucích selhání a poslední výsledek. V doručené poště se u každého dodavatele objeví jen poslední selhání, takže obnovená synchronizace kartu odstraní.
3. Karty zmizí samy, jakmile se podkladový stav vyřeší (agent dostane odpověď, synchronizace se vzpamatuje) — ručně je zavírat nejde.

Jsou to potvrzení na jeden tah, ne schválení ve správě

Karta „schválení agenta“ je běžící agent, který se ve vlastní konverzaci zastaví a požádá o svolení k jedné akci. Od záznamu Approval ve správě, který agenti zakládají nástroji MCP pro schválení, se liší. Pro ty záznamy nikde v aplikaci není obrazovka pro člověka a sem se nikdy nedostanou.

Zdraví synchronizace je jen ke čtení

Karta podává zprávu o připojeních synchronizace ticketů. Kromě tlačítka Synchronizovat teď neumí připojení vytvořit, upravit ani znovu připojit a žádná jiná obrazovka to neumí taky. Když žádné připojení nastavené není, prostě píše „Zatím žádná připojení synchronizace“, což ukáže čerstvý pracovní prostor.

Filtruj na to, co blokuje

1. Stiskni f (když kurzor není v textovém poli) a otevři nabídku filtrů, nebo klikni na tlačítko filtru v nástrojové liště.
2. Vyber libovolnou kombinaci stavu, autora, recenzentů, obsahu, vlastníka nebo názvu repozitáře, časových oken, nebo Rychlé ke kontrole. Počty u voleb v nabídce ukážou, kolika položkám doručené pošty každá možnost odpovídá.
3. Aktivní filtry se ukážou jako štítky v liště nad seznamem. Kliknutím na ✕ u štítku to kritérium zahodíš.
4. Levou lištou skákej mezi sekcemi — každá položka ukazuje aktuální počet a zvýraznění sleduje, kam jsi odroloval. Kliknutím na záhlaví sekce sbalíš ty, které netřídíš (třeba Koncepty, když vyřizuješ kontroly).
5. Klikni na záhlaví sloupce (Název, Změny nebo Aktualizováno) a seřadíš každou sekci. Dalším kliknutím na aktivní sloupec otočíš směr. Tlačítko Možnosti zobrazení řídí zobrazení konceptů, okno sloučení, zobrazené vlastnosti, řazení a seskupení (rozložení doručené pošty změní jen seskupení podle autora).

Filtry tady jsou nezávislé na frontě PR — zúžení doručené pošty nikdy nezmění filtry fronty a naopak.

Jednej u položky PR

1. Klikni na libovolný řádek a otevřeš stránku detailu PR.
2. Když je PR v sekci Potřebuje vaši kontrolu, zkontroluj ho a odešli rozhodnutí — viz Zkontrolujte a sloučte PR.
3. Když je PR v sekci Vráceno vám (vyžádány změny, nebo selhalo CI), pošli opravy ze svého checkoutu, nebo navazující práci předej agentovi.
4. Když je PR v sekci Schváleno, slouč ho ze stránky detailu.
5. Když chceš kontrolu raději předat, než ji dělat sám, viz Odešlete review agenty a životní cyklus odeslání agenta.

Jakmile se podkladový stav změní (dorazí tvoje kontrola, PR se sloučí), klasifikátor PR sám zařadí do nové sekce.

Vezmi zpět chybnou akci

1. Stiskni ⌘Z a vezmi poslední akci zpět, ⌘⇧Z ji udělej znovu.
2. Když je kurzor v textovém poli, ⌘Z upraví text v poli — nejdřív klikni mimo pole, ať vezmeš zpět akci na úrovni aplikace.

Najdi zkratky na místě

Stiskni ? (když kurzor není v textovém poli) a otevřeš přehled klávesových zkratek. Vypíše každou zkratku platnou na aktuální trase, včetně filtru doručené pošty f. Celá mapa je v Klávesové zkratky.

Ovládej ji z palety příkazů

1. Stiskni ⌘K kdekoli a otevři paletu příkazů.
2. Napiš Doručená pošta a skočíš na stránku, nebo napiš název PR — paleta vypíše odpovídající pull requesty a otevře ten, který vybereš.
3. Když máš doručenou poštu otevřenou, spusť Kopírovat odkaz na tuto stránku a zkopíruj tu adresu ke sdílení. Příkaz kopíruje aktuální trasu, takže je to adresa doručené pošty jen tehdy, když jsi na téhle stránce.

Obnov na požádání

Doručená pošta se aktualizuje živě. Když máš podezření na zastaralá data, klikni na ovládání obnovení v nástrojové liště — vynutí okamžitý průchod na serveru přes každou připojenou forge a znovu načte překryvy sloučených a zkontrolovaných. Ikona se točí, dokud každé načtení nedoběhne.

Související návody

• Zkontrolujte a sloučte PR
• Chatujte s agentem
• Odešlete review agenty

Související koncepty

• Životní cyklus odeslání agenta