Entwicklung
gh-fix-ci
Analysiert fehlgeschlagene GitHub-Actions-Checks in PRs und schlägt einen Fix-Plan vor
Dieser Skill automatisiert das Debuggen fehlgeschlagener Checks in GitHub-Pull-Requests, die über GitHub Actions laufen. Über die gh-CLI ermittelt er die zugehörige PR, identifiziert fehlgeschlagene Checks und lädt die relevanten Job-Logs herunter, um daraus einen aussagekräftigen Fehler-Ausschnitt zu extrahieren. Ein mitgeliefertes Python-Skript übernimmt dabei das Auslesen der Check-Felder inklusive Fallback-Logik, falls sich die gh-Ausgabe ändert oder Logs noch nicht vollständig vorliegen.
Externe CI-Anbieter wie Buildkite werden bewusst nicht analysiert, sondern nur mit ihrer Details-URL gemeldet, damit der Workflow auf GitHub Actions fokussiert bleibt. Nach der Zusammenfassung der Fehlerursache erstellt der Skill einen konkreten Fix-Plan und setzt ihn erst nach ausdrücklicher Freigabe um, bevor er zum erneuten Prüfen der Checks anregt. Damit eignet er sich für Entwickler und Teams, die wiederkehrende CI-Fehler in Pull-Requests schneller nachvollziehen und beheben wollen, ohne manuell durch Logs zu scrollen.
FAQ
Häufige Fragen zu gh-fix-ci
- Welche Voraussetzungen müssen erfüllt sein, damit gh-fix-ci funktioniert?
- Der Skill benötigt eine authentifizierte GitHub-CLI (gh auth login) mit repo- und workflow-Scopes, geprüft über gh auth status. Zusätzlich wird Python für das mitgelieferte Skript scripts/inspect_pr_checks.py vorausgesetzt, das die Check-Daten und Logs ausliest.
- Werden auch CI-Systeme wie Buildkite oder CircleCI analysiert?
- Nein, der Skill konzentriert sich bewusst auf GitHub Actions. Checks von externen Anbietern werden erkannt und als solche markiert, aber nur mit ihrer Details-URL gemeldet statt inhaltlich analysiert.
- Nimmt der Skill automatisch Code-Änderungen vor, um die CI-Fehler zu beheben?
- Nein, er erstellt zunächst nur einen Fehler-Report und einen Fix-Plan. Änderungen am Code werden laut Workflow erst nach ausdrücklicher Freigabe umgesetzt, bevor anschließend zum erneuten Prüfen der Checks angeregt wird.
- Wie findet der Skill die passende Pull Request, wenn ich keine PR-Nummer angebe?
- Standardmäßig ermittelt er die PR über den aktuellen Branch mittels gh pr view. Alternativ kann eine PR-Nummer oder URL direkt als Parameter übergeben werden, um einen anderen Pull Request zu prüfen.