Arbeitsablauf
Review-Ablauf
Änderungen nachvollziehbar zur Prüfung geben.
Branch → Commit → Push → Pull Request → Review + CI → Merge
Branch-Regeln und erforderliche Freigaben des Repositorys beachten.
Arbeitsablauf
Zielkonto prüfen
Vor Remote-Aktionen das verwendete Konto kontrollieren.
gh auth status
Statusausgaben vor Weitergabe auf interne Angaben prüfen; keine Tokens ausgeben.
Arbeitsablauf
PRs finden
Offene Pull Requests im aktuellen Repository ansehen.
gh pr list --state open
Im richtigen Repository arbeiten; Nummern gelten repositorybezogen.
Arbeitsablauf
Änderung lesen
Beispiel-PR 123 vor einer Entscheidung ansehen.
gh pr view 123
gh pr diff 123
Diff und Beschreibung gemeinsam prüfen; dies genehmigt oder merged nichts.
Arbeitsablauf
CI prüfen
Status der Prüfungen für einen PR lesen.
gh pr checks 123
Grüne CI beweist nicht automatisch fachliche Richtigkeit oder Sicherheit.
Arbeitsablauf
Draft-PR erstellen
Geprüften Branch als Entwurf veröffentlichen; pr.md enthält die Beschreibung.
gh pr create --draft --title "Catalog owner review" --body-file pr.md
Veröffentlicht einen PR im Remote-Repository; Branch/Datei und berechtigte Zielgruppe vorab prüfen.
Arbeitsablauf
Repository-Kontext prüfen
Vor Schreibaktionen Zielrepository bestätigen.
gh repo view --json nameWithOwner,defaultBranchRef,url
Für Skripte -R OWNER/REPO explizit ergänzen.
Arbeitsablauf
Dateiliste eines PR lesen
Review anhand betroffener Dateien eingrenzen.
gh pr view 123 --json files --jq ".files[].path"
Dateiliste ersetzt keine Diff-Prüfung.
Betrieb & Fehlersuche
Workflow-Läufe finden
Fehlgeschlagene und laufende CI-Läufe finden.
gh run list --limit 10
Run-ID und zugehörigen Commit vor Diagnose abgleichen.
Betrieb & Fehlersuche
Fehlerprotokoll eines Laufs lesen
Nur fehlgeschlagene Schritte eines bekannten Laufs lesen.
gh run view 123456 --log-failed
Logs können sensible Werte enthalten; vor Weitergabe bereinigen.
Betrieb & Fehlersuche
Lauf bis zum Ergebnis beobachten
In einer Shell auf einen bestimmten Lauf warten.
gh run watch 123456 --exit-status
Exit-Code bezieht sich auf diesen Lauf, nicht automatisch auf alle erforderlichen PR-Checks.
Arbeitsablauf
Offene Aufgaben finden
Bekannte Restlücken vor Freigabe durchsehen.
gh issue list --state open --limit 20
Ein leeres Ergebnis beweist keine vollständige Risikofreiheit.
Arbeitsablauf
Review-Branch lokal öffnen
Pull Request in einem sauberen lokalen Checkout untersuchen.
git status --short
gh pr checkout 123
Wechselt den Arbeitsstand. Vorher lokale Änderungen sichern oder einen separaten Checkout verwenden.
Sicherheit & Rechte
Workflow-Rechte begrenzen
Ein kleines Rechtebudget für einen lesenden Workflow festlegen.
permissions:
contents: read
Jobs können andere Rechte benötigen. Ungeprüften PR-Code nicht mit Produktions-Secrets ausführen.
Betrieb & Fehlersuche
Veraltete PR-Läufe abbrechen
Parallelität für denselben Review-Kontext begrenzen.
concurrency:
group: review-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
Fragment innerhalb einer Workflow-Datei. Für produktive Deployments Abbruchfolgen separat bewerten.
Arbeitsablauf
Verfügbare Workflows sehen
Workflow-Namen und IDs vor CI-Diagnose feststellen.
gh workflow list
Deaktivierte Workflows werden je Option anders angezeigt; Ausgabe bewusst eingrenzen.
Arbeitsablauf
Workflow-Datei ansehen
Die verwendete Workflow-Definition lesen.
gh workflow view ci.yml --yaml
Branchbezug mit dem betroffenen Lauf vergleichen; neueste Definition und alter Lauf können abweichen.
Betrieb & Fehlersuche
Run und Commit verbinden
Ergebnis mit Commit und Auslöser dokumentieren.
gh run view 123456 --json headSha,event,status,conclusion,url
Run-ID ist ein Beispiel. Ein erfolgreicher Lauf allein belegt keine Fachfreigabe.
Arbeitsablauf
Repository-Labels lesen
Vor Verwendung eines Labels bestehende Namen prüfen.
gh label list --limit 50
Erste Seite ist kein Vollständigkeitsnachweis bei größeren Beständen.
Betrieb & Fehlersuche
Artefakte eines Laufs laden
Manifest und Testergebnis eines freigegebenen Laufs lokal vergleichen.
gh run download 123456 --dir ./review-artifacts
Lädt Dateien herunter. Aufbewahrung, sensible Inhalte und Überschreibungen im Zielordner prüfen; nicht ausführen.
