gh-issues

• Sie haben einen Backlog klar abgegrenzter Bug-Issues und möchten einen automatisierten Lösungsversuch als ersten Durchlauf vor der menschlichen Überprüfung.
• Sie betreiben eine geplante CI/Cron-Pipeline und möchten, dass Issues automatisch triagiert und per PR eingereicht werden, ohne manuellen Eingriff (--cron-Modus).
• Sie arbeiten mit einem Fork-basierten Beitragsmodell und benötigen Branches, die in Ihren Fork gepusht werden, mit PRs, die auf ein Upstream-Repository abzielen (--fork).
• Sie möchten, dass Review-Kommentare zu PRs automatisch bearbeitet werden — verwenden Sie --reviews-only, damit gh-issues offene fix/issue-*-PRs scannt und Korrekturen für angeforderte Änderungen pusht.

• Issues sind vage, architektonischer Natur oder haben einen großen Umfang — die Sub-Agenten von gh-issues bewerten ihre eigene Konfidenz und überspringen Issues, die sie mit weniger als 7/10 bewerten, aber hochkomplexe Issues sollten manuell bearbeitet werden.
• Sie benötigen garantierte Korrektheit — Sub-Agenten führen Tests aus, wenn verfügbar, aber automatisch generierte Fixes sollten vor dem Merge in die Produktion überprüft werden.
• Sie haben kein GitHub-Token (GH_TOKEN) — die gh-issues-Skill kann sich ohne dieses Token nicht bei einer GitHub-API authentifizieren.

Bis zu 8 Unteragenten laufen gleichzeitig, wobei jeder ein einzelnes Issue von Anfang bis Ende bearbeitet: Branch-Erstellung, Code-Analyse, Fehlerbehebung, Testausführung, Commit, Push und PR-Eröffnung. Jeder Agent verfügt über ein 60-Minuten-Budget und eine integrierte Konfidenzprüfung – Issues, die er nicht mit einer Konfidenz von ≥7/10 lösen kann, werden übersprungen.

Nachdem Pull Requests geöffnet wurden, ruft Phase 6 Reviews, Inline-Kommentare, allgemeine PR-Kommentare und sogar eingebettete Bot-Reviews (z. B. Greptile) ab. Umsetzbare Kommentare lösen zusätzliche Sub-Agenten aus, die den Branch auschecken, die angeforderten Änderungen anwenden, ein Update pushen und auf jeden Kommentar mit dem Commit-SHA antworten.

Übergebe --fork user/repo, um alle Branches in deinen Fork zu pushen und Pull Requests vom Fork aus zu öffnen, die auf das ursprüngliche Upstream-Repository abzielen – entsprechend dem standardmäßigen Open-Source-Beitrags-Workflow, ohne dass ein Schreibzugriff auf das Upstream-Repository erforderlich ist.

--cron ermöglicht eine "Fire-and-Forget"-Planung: Der Orchestrator wählt ein geeignetes Issue aus, startet einen Sub-Agenten und beendet sich sofort – sicher, um es alle paar Minuten aus einem Cron-Job aufzurufen. --watch hält den Orchestrator am Laufen und fragt in einem konfigurierbaren Intervall nach neuen Issues und Review-Kommentaren.

Vor dem Starten prüft der Skill, ob bereits offene PRs, in Bearbeitung befindliche Branches im Push-Repository und eine lokale Claims-Datei mit einer Ablaufzeit von 2 Stunden vorhanden sind. Dies verhindert, dass doppelte Sub-Agenten bei überlappenden Cron-Läufen oder Watch-Zyklen gleichzeitig an demselben Issue arbeiten.

Übergeben Sie --notify-channel mit einer Telegram-Kanal-ID, um eine abschließende Zusammenfassungsnachricht mit PR-Links und Ergebnissen pro Issue zu erhalten. Nur das endgültige Ergebnis wird gesendet – keine Zwischenstatusaktualisierungen.

Führe /gh-issues owner/repo --label bug --limit 10 --cron aus einem geplanten Job heraus aus. Bei jedem Aufruf wird das nächste nicht beanspruchte Bug-Issue ausgewählt, ein Unter-Agent zur Implementierung eines Fixes gestartet und der Prozess beendet. Im Laufe der Zeit wird der Rückstand schrittweise abgearbeitet, ohne dass zwischen den Durchläufen ein menschliches Eingreifen erforderlich ist.

Verwende /gh-issues upstream/project --fork myfork/project --label good-first-issue, damit der Skill Issues aus dem Upstream-Repository abruft, Fix-Branches in deinen Fork pusht und Pull Requests öffnet, die auf das Upstream-Projekt abzielen – ganz im Sinne des Standard-Contributor-Workflows.

Planen Sie /gh-issues owner/repo --reviews-only --cron parallel zu Ihrer bestehenden PR-Pipeline. Jeder Durchlauf scannt offene fix/issue-*-PRs auf unbeantwortete CHANGES_REQUESTED-Reviews oder Inline-Kommentare, wählt den ersten unbearbeiteten PR aus und startet einen Agenten, der die angeforderten Änderungen umsetzt und antwortet.

Führe /gh-issues owner/repo --label enhancement --watch --interval 10 während einer Sprint-Planungssitzung aus. Der Skill ruft Issues ab, bittet dich zu bestätigen, welche verarbeitet werden sollen, startet Agenten und prüft alle 10 Minuten auf neue Issues und Review-Feedback — und zeigt kumulative Ergebnisse an, bis du „stop" sagst.