Triagea din inkorg
Den här guiden visar hur du arbetar i inkorgen: den enda ytan som samlar allt som blockerar dig eller uttryckligen frågar efter dig – väntande agentgodkännanden, misslyckade ärendesynkar och varje pull request som rör dig som granskare eller författare.
Öppna inkorgen
Avsnitt med rubriken “Öppna inkorgen”- Klicka på Inkorg i sidofältet. Dess märke räknar väntande agentgodkännanden, misslyckade synkar och öppna PR:ar som väntar på din granskning.
- Eller tryck på ⌘K och kör navigeringskommandot Inkorg.
- Eller djuplänka direkt till
/workspaces/<workspace-id>/inbox.
Posten i sidofältet visar alltid det aktuella antalet, så du ser triagearbetet växa utan att öppna sidan.
Se allvarlighetsgraden i ett svep
Avsnitt med rubriken “Se allvarlighetsgraden i ett svep”Skanna uppifrån och ned; inkorgen är redan ordnad efter brådska:
- Den fästa raden Behöver din uppmärksamhet ligger ovanför PR-sektionerna. Varje kort har en allvarlighetsbricka. Registrerade källor (en agent som fastnat på en bekräftelseprompt, en ärendesynk vars leverantörsspegel är inaktuell) ger Blockerad.
- Inom raden kommer den mest brådskande allvarlighetsgraden först; vid lika vinner posten som har väntat längst.
- Under raden grupperas PR:ar i fasta sektioner för granskningslivscykeln – Behöver din granskning, Åter till dig, Godkända, Utkast, Väntar på granskare, Sammanslås och nyligen sammanslagna, Väntar på författare. De översta sektionerna är det som behöver dig; resten är var dina PR:ar står. Behöver din granskning omfattar PR:ar som fortfarande begär ett team som du tillhör, hos kodvärdar som har team (GitHub tar bort teamet så snart någon i teamet har granskat).
En post hamnar bara i inkorgen när den blockerar något eller uttryckligen frågar efter dig. En tom rad plus en tom sektionslista visar Du är ikapp bara när tomheten går att lita på.
En inkorg över alla kodvärdar
Avsnitt med rubriken “En inkorg över alla kodvärdar”Om arbetsytan har repos hos mer än en kodvärd slår inkorgen samman dem till en
enda ström – en pull request från GitHub och en från Bitbucket ligger i samma
sektion, sorterade efter tid i stället för grupperade efter leverantör. Radens
repo #number-metadata är det som skiljer dem åt.
”Dina” avgörs per kodvärd, eftersom du är ett annat konto hos var och en. En pull request räknas bara som din, eller som en begäran om din granskning, när den matchar din identitet hos den kodvärd som repot faktiskt ligger hos.
En kodvärd som ligger nere eller inte är ansluten bidrar inte med något och lämnar resten av inkorgen orörd – en trasig anslutning tömmer aldrig hela listan. Tomtillståndet anger ett förbehåll i stället för Du är ikapp när varje kodvärdsinloggning fortfarande är olöst (Kunde inte bekräfta ditt GitHub-konto – texten nämner fortfarande GitHub), när githubstatus.com rapporterar en incident, eller när en GitHub App-installation som täcker länkade repos är avstängd.
Rensa uppmärksamhetsraden
Avsnitt med rubriken “Rensa uppmärksamhetsraden”Varje kort i raden har en enda nästa åtgärd:
- Om ett kort är en väntande agentbekräftelse klickar du på Granska – du hamnar i agentens yta med dess väntande bekräftelse. Godkänn eller avvisa där (se Chatta med en agent).
- Om ett kort säger Synken misslyckades för en leverantör klickar du på Öppna – du hamnar i Inställningar → Arbetsyta → Allmänt, vars kort Synkhälsa visar varje anslutnings senaste synk, antal fel i följd och senaste utfall. Bara det senaste felet per leverantör visas i inkorgen, så en återställd synk rensar kortet.
- Korten försvinner av sig själva när det underliggande tillståndet är löst (agenten har fått svar, synken har återställts) – det finns inget att stänga manuellt.
Filtrera fram det som blockerar
Avsnitt med rubriken “Filtrera fram det som blockerar”- Tryck på f (utan att något textfält har fokus) för att öppna filtermenyn, eller klicka på filterknappen i verktygsfältet.
- Välj valfri kombination av status, författare, granskare, innehåll, repoägare eller -namn, datumintervall eller snabba att granska. Fasettantalen i menyn visar hur många inkorgsposter varje alternativ matchar.
- Aktiva filter visas som brickor i raden ovanför listan; klicka på en brickas ✕ för att ta bort det kriteriet.
- Använd vänsterpanelen för att hoppa mellan sektioner – varje post visar sitt aktuella antal och markeringen följer din rullningsposition. Klicka på en sektionsrubrik för att fälla ihop sektioner som du inte triagear (till exempel Utkast när du rensar granskningar).
- Klicka på en kolumnrubrik (titel, ändringar eller uppdaterad) för att sortera alla sektioner; klicka på den aktiva kolumnen igen för att vända riktningen. Knappen för visningsalternativ styr synligheten för utkast, fönstret för nyligen sammanslagna, radegenskaper, ordning och gruppering (bara gruppering efter författare ändrar inkorgens layout).
Filtren här är oberoende av PR-kön – att avgränsa inkorgen ändrar aldrig könens filter och tvärtom.
Agera på en PR-post
Avsnitt med rubriken “Agera på en PR-post”- Klicka på valfri rad för att öppna PR:ens detaljsida.
- Om PR:en ligger i Behöver din granskning granskar du den och skickar in ditt beslut – se Granska och slå ihop en PR.
- Om PR:en ligger i Åter till dig (ändringar begärda eller CI misslyckades) pushar du åtgärder från din utcheckning eller lämnar över uppföljningen till en agent.
- Om PR:en ligger i Godkända slår du ihop den från detaljsidan.
- Om du hellre delegerar en granskning än gör den själv, se Starta granskningsagenter och livscykeln för agentdispatch.
När det underliggande tillståndet ändras (din granskning landar, PR:en slås ihop) placerar klassificeraren automatiskt om PR:en i sin nya sektion.
Ångra en felaktig åtgärd
Avsnitt med rubriken “Ångra en felaktig åtgärd”- Tryck på ⌘Z för att ångra den senaste åtgärden, ⌘⇧Z för att göra om den.
- Om ett textfält har fokus redigerar ⌘Z fältets text i stället – klicka bort från fältet först för att ångra en åtgärd på appnivå.
Slå upp genvägar på plats
Avsnitt med rubriken “Slå upp genvägar på plats”Tryck på ? (utan att något textfält har fokus) för att öppna fuskbladet med tangentbordsgenvägar. Det listar varje bindning som är aktiv på den aktuella rutten, inklusive inkorgens filtergenväg f. Hela kartan finns i referensen för tangentbordsgenvägar.
Styr den från kommandopaletten
Avsnitt med rubriken “Styr den från kommandopaletten”- Tryck på ⌘K var som helst för att öppna kommandopaletten.
- Skriv Inkorg för att hoppa till sidan, eller skriv en PR-titel – paletten listar matchande pull requests och öppnar den du väljer.
- Medan inkorgen är öppen kör du Kopiera länk till den här sidan för att kopiera URL:en för delning. Kommandot kopierar den aktuella rutten, så det är inkorgens URL bara när du är på den här sidan.
Uppdatera vid behov
Avsnitt med rubriken “Uppdatera vid behov”Inkorgen uppdateras live, men om du misstänker inaktuella data klickar du på uppdateringskontrollen i verktygsfältet – den tvingar fram en omedelbar genomsökning på serversidan av varje ansluten kodvärd och hämtar om överläggen för sammanslagna och granskade. Ikonen snurrar tills varje hämtning har slutförts.