GitHub-Issue-Integration einrichten

Die mit Abstand wertvollste Automatisierung in CodeCourier ist diejenige, die den manuellen Schritt zwischen "Ticket existiert in GitHub" und "Agent arbeitet daran" eliminiert. Dieses 15-minütige Setup ist der Unterschied zwischen einem Tool, an das Sie sich erinnern müssen, und einem Tool, das einfach da ist.

1. GitHub App installieren

Öffnen Sie im CodeCourier-Dashboard Integrations → GitHub und klicken Sie auf Install GitHub App. Wählen Sie die zu verbindende Org und vergeben Sie die minimalen Scopes: Repository Contents (read + pull-request-create), Issues (read + write) und Webhook-Events.

Auf GitHub-Seite entweder "All repositories" oder eine spezifische Liste wählen. Starten Sie für den ersten Lauf mit ein, zwei Repos; später erweitern, ohne neu zu installieren.

2. Ein Trigger-Label wählen

CodeCourier lauscht auf das Anwenden eines Labels. Wählen Sie einen Label-Namen, der offensichtlich kein normales Triage-Label ist - wir empfehlen codecourier:run. Legen Sie es in jedem verbundenen Repo an.

# Label auf einem Repo anlegen
gh label create "codecourier:run" \
  --description "Dieses Issue an CodeCourier übergeben" \
  --color "00CAE5"

Die cyanfarbene Tönung ist ein kleines Detail, zählt aber: Das Label hebt sich auf einen Blick von Priority- und Triage-Labels ab.

3. Labels auf Personas mappen

In den Integration-Einstellungen definieren Sie ein Mapping von GitHub-Label auf CodeCourier-Persona. Hier kodieren Sie Policy, ohne Code zu schreiben.

• codecourier:run → Default-Persona für dieses Repo.
• codecourier:frontend → Frontend-Specialist-Persona.
• codecourier:backend → Backend-Specialist-Persona.
• codecourier:investigate → Researcher-Persona (read-only Session, die einen Kommentar emittiert, kein PR).

4. State-Sync verkabeln

Aktivieren Sie den Zwei-Wege-State-Sync. Eine Issue Session, die in CodeCourier auf in-progress steht, setzt das GitHub-Issue auf in progress; ein gemergter PR schließt das Issue automatisch. Schließt jemand das Issue manuell auf GitHub, wird eine aktive Session abgebrochen - der menschliche Override gewinnt immer.

State-Sync ist der Grund, warum die Integration nativ wirkt statt aufgeklebt. Ohne ihn hält Ihr Team dauerhaft zwei Tabs offen.

5. Mit einem bekannten Issue testen

Wählen Sie ein offenes Issue, das Sie bereits manuell triagiert haben. Setzen Sie codecourier:run darauf. Innerhalb weniger Sekunden taucht eine Issue Session im CodeCourier-Dashboard auf, ein Kommentar im GitHub-Issue verlinkt zurück, und der Status springt auf in progress.

Warten Sie auf das Ende der Session, prüfen Sie den entstandenen Pull Request und mergen Sie. Das Issue schließt automatisch beim Merge.

6. Sicherheitsnetz ergänzen

Setzen Sie in den Integration-Einstellungen ein Tageslimit pro Repo. Neue Nutzer starten mit 50 $/Tag pro Repo. Damit ist der Blast Radius begrenzt, falls jemand versehentlich tausend Issues auf einmal labelt - und genau das passiert irgendwann.

7. Nächste Schritte

Sobald die Integration läuft, sind die offensichtlichen Upgrades: Sprint Chains an getriggerte Läufe binden, sodass ein einzelnes Label eine mehrstufige Pipeline startet - und das Operations-Handbuch lesen, bevor Sie die Integration org-weit aktivieren.