Deinen Posteingang triagieren
Diese Anleitung zeigt, wie du den Posteingang abarbeitest: die eine Oberfläche, die alles sammelt, was dich blockiert oder dich ausdrücklich anfordert. Ausstehende Agenten-Freigaben, fehlgeschlagene Ticket-Synchronisierungen und jeder Pull Request, an dem du als Reviewer oder Autor beteiligt bist.
Den Posteingang öffnen
Abschnitt betitelt „Den Posteingang öffnen“- Klicke in der Seitenleiste auf Posteingang. Das Badge zählt ausstehende Agenten-Freigaben, fehlgeschlagene Synchronisierungen und offene PRs, die auf dein Review warten.
- Oder drücke ⌘K und führe den Navigationsbefehl Posteingang aus.
- Oder verlinke direkt auf
/workspaces/<workspace-id>/inbox.
Der Eintrag in der Seitenleiste zeigt immer die Live-Zahl, deshalb siehst du, wie sich die Triage-Arbeit anhäuft, ohne die Seite zu öffnen.
Den Schweregrad auf einen Blick lesen
Abschnitt betitelt „Den Schweregrad auf einen Blick lesen“Lies von oben nach unten. Der Posteingang ist schon nach Dringlichkeit geordnet:
- Die angeheftete Leiste Braucht deine Aufmerksamkeit sitzt über den PR-Abschnitten. Jede Karte trägt einen Schweregrad-Chip. Registrierte Quellen (ein Agent, der an einer Bestätigungsrückfrage hängt, eine Ticket-Synchronisierung, deren Anbieter-Spiegel veraltet ist) melden Blockiert.
- In der Leiste kommt der dringendste Schweregrad zuerst. Bei Gleichstand gewinnt der Eintrag, der am längsten wartet.
- Unter der Leiste sind PRs in feste Abschnitte des Review-Lebenszyklus gruppiert: Wartet auf dein Review, An dich zurückgegeben, Genehmigt, Entwürfe, Wartet auf Reviewer, Wird gemergt und kürzlich gemergt, Wartet auf den Autor. Die oberen Abschnitte sind das, was dich braucht; der Rest zeigt, wo deine PRs stehen. Wartet auf dein Review umfasst PRs, die auf Code-Hosts mit Teams weiterhin ein Team anfordern, dem du angehörst (GitHub lässt das Team fallen, sobald irgendein Teammitglied reviewt).
Ein Eintrag landet nur im Posteingang, wenn er etwas blockiert oder dich ausdrücklich anfordert. Eine leere Leiste plus eine leere Abschnittsliste zeigt Alles erledigt nur, wenn diese Leere vertrauenswürdig ist.
Ein Posteingang über jeden Code-Host
Abschnitt betitelt „Ein Posteingang über jeden Code-Host“Liegen im Arbeitsbereich Repos auf mehr als einem Code-Host, führt der
Posteingang sie zu einem Strom zusammen. Ein Pull Request von GitHub und einer
von Bitbucket stehen im selben Abschnitt, nach Zeit geordnet statt nach
Anbieter gruppiert. Die Meta-Angabe repo #number in der Zeile unterscheidet
sie.
„Deins“ wird je Code-Host aufgelöst, weil du auf jedem ein anderes Konto bist. Ein Pull Request zählt nur als deiner, oder als Anfrage an dein Review, wenn er zu deiner Identität auf dem Code-Host passt, auf dem das Repo tatsächlich liegt.
Ein Code-Host, der ausfällt oder nicht verbunden ist, trägt nichts bei und lässt den Rest des Posteingangs intakt. Eine kaputte Verbindung leert nie die ganze Liste. Der Leerzustand nennt einen Vorbehalt statt Alles erledigt, wenn jede Code-Host-Anmeldung noch unaufgelöst ist (Dein GitHub-Konto konnte nicht bestätigt werden — der Text nennt weiter GitHub), wenn githubstatus.com einen Vorfall meldet oder wenn eine GitHub App, die verknüpfte Repos abdeckt, gesperrt ist.
Die Aufmerksamkeitsleiste abarbeiten
Abschnitt betitelt „Die Aufmerksamkeitsleiste abarbeiten“Jede Karte in der Leiste hat genau eine nächste Aktion:
- Ist eine Karte eine ausstehende Agenten-Bestätigung, klicke auf Prüfen. Du landest im Bereich dieses Agenten, bei der ausstehenden Bestätigung. Genehmige oder verweigere sie dort (siehe Mit einem Agenten chatten).
- Sagt eine Karte Synchronisierung fehlgeschlagen für einen Anbieter, klicke auf Öffnen. Du landest unter Einstellungen → Arbeitsbereich → Allgemein. Die Karte Sync-Status zeigt je Verbindung die letzte Synchronisierung, die Serie aufeinanderfolgender Fehlschläge und das letzte Ergebnis. Im Posteingang erscheint nur der letzte Fehlschlag je Anbieter, deshalb verschwindet die Karte, sobald die Synchronisierung wieder läuft.
- Die Karten verschwinden von selbst, sobald der zugrunde liegende Zustand sich auflöst (der Agent ist beantwortet, die Synchronisierung erholt sich). Manuell wegwischen gibt es nicht.
Auf das filtern, was blockiert
Abschnitt betitelt „Auf das filtern, was blockiert“- Drücke f (wenn kein Textfeld den Fokus hat), um das Filtermenü zu öffnen, oder klicke auf die Filter-Schaltfläche in der Werkzeugleiste.
- Wähle eine beliebige Kombination aus Status, Autor, Reviewern, Inhalt, Repository-Eigentümer oder -Name, Datumsfenstern oder Schnell zu reviewen. Die Facettenzahlen im Menü zeigen, wie viele Posteingang-Einträge zu jeder Option passen.
- Aktive Filter erscheinen als Chips in der Leiste über der Liste. Klicke auf das ✕ eines Chips, um dieses Kriterium zu entfernen.
- Nutze die linke Leiste, um zwischen Abschnitten zu springen. Jeder Eintrag zeigt seine Live-Zahl, und die Hervorhebung folgt deiner Scrollposition. Klicke auf eine Abschnittsüberschrift, um Abschnitte einzuklappen, die du nicht triagierst (zum Beispiel Entwürfe, während du Reviews abarbeitest).
- Klicke auf eine Spaltenüberschrift (Titel, Änderungen oder Aktualisiert), um jeden Abschnitt zu sortieren. Klicke die aktive Spalte noch einmal, um die Richtung umzukehren. Die Schaltfläche Anzeigeoptionen steuert, ob Entwürfe sichtbar sind, das Merge-Zeitfenster, die Anzeigeeigenschaften, die Sortierung und die Gruppierung (nur die Gruppierung nach Autor ändert das Layout des Posteingangs).
Die Filter hier sind unabhängig von der PR-Warteschlange. Den Posteingang einzuengen ändert nie die Filter der Warteschlange, und umgekehrt.
Einen PR-Eintrag bearbeiten
Abschnitt betitelt „Einen PR-Eintrag bearbeiten“- Klicke auf eine beliebige Zeile, um die PR-Detailseite zu öffnen.
- Liegt der PR in Wartet auf dein Review, prüfe ihn und gib deine Entscheidung ab. Siehe Einen PR prüfen und mergen.
- Liegt der PR in An dich zurückgegeben (Änderungen angefordert oder CI fehlgeschlagen), pushe die Korrekturen aus deinem Checkout oder übergib die Nacharbeit einem Agenten.
- Liegt der PR in Genehmigt, merge ihn von der Detailseite.
- Wenn du ein Review lieber delegierst, als es selbst zu machen, siehe Reviewer-Agenten starten und den Lebenszyklus der Agenten-Ausführung.
Sobald sich der zugrunde liegende Zustand ändert (dein Review ist da, der PR wird gemergt), legt der Klassifikator den PR automatisch in den neuen Abschnitt.
Eine falsche Aktion rückgängig machen
Abschnitt betitelt „Eine falsche Aktion rückgängig machen“- Drücke ⌘Z, um die letzte Aktion rückgängig zu machen, ⌘⇧Z, um sie zu wiederholen.
- Hat ein Textfeld den Fokus, bearbeitet ⌘Z stattdessen den Text des Feldes. Klicke zuerst aus dem Feld, um eine Aktion auf App-Ebene rückgängig zu machen.
Tastenkürzel an Ort und Stelle nachschlagen
Abschnitt betitelt „Tastenkürzel an Ort und Stelle nachschlagen“Drücke ? (wenn kein Textfeld den Fokus hat), um die Tastenkürzelübersicht zu öffnen. Sie listet jede Belegung, die auf der aktuellen Route aktiv ist, einschließlich des Filterkürzels f des Posteingangs. Die vollständige Karte steht unter Tastenkürzel.
Über die Befehlspalette steuern
Abschnitt betitelt „Über die Befehlspalette steuern“- Drücke ⌘K irgendwo, um die Befehlspalette zu öffnen.
- Tippe Posteingang, um zur Seite zu springen, oder tippe einen PR-Titel. Die Palette listet passende Pull Requests und öffnet den, den du wählst.
- Solange der Posteingang offen ist, führe Link zu dieser Seite kopieren aus, um diese URL zum Teilen zu kopieren. Der Befehl kopiert die aktuelle Route, deshalb ist es die Posteingang-URL nur, wenn du auf dieser Seite bist.
Bei Bedarf aktualisieren
Abschnitt betitelt „Bei Bedarf aktualisieren“Der Posteingang aktualisiert sich live. Vermutest du veraltete Daten, klicke auf die Aktualisieren-Steuerung in der Werkzeugleiste. Sie erzwingt sofort einen serverseitigen Durchlauf über jeden verbundenen Code-Host und lädt die Overlays für gemergte und geprüfte PRs neu. Das Symbol dreht sich, bis jede Abfrage abgeschlossen ist.