gh-fix-ci

Use when a user asks to debug or fix failing GitHub PR checks that run in GitHub Actions; use gh to inspect checks and logs, summarize failure context, draft a fix plan, and implement only after explicit approval. Treat external providers (for example Buildkite) as out of scope and report only the details URL.

1. Upewnij się, że masz zainstalowany GitHub CLI i jesteś zalogowany. Uruchom gh auth status w swoim repozytorium — powinna być wyświetlona informacja o autentykacji z zakresami dostępu do repozytorium i workflow. Jeśli nie jesteś zalogowany, wykonaj gh auth login i potwierdź wymagane zakresy dostępu.

2. Przygotuj numer lub URL pull requesta, który chcesz debugować. Jeśli pracujesz na gałęzi powiązanej z PR, umiejętność automatycznie rozpozna bieżący PR — w przeciwnym razie podaj numer lub URL.

3. Uruchom skrypt inspekcji, aby pobrać logi GitHub Actions. Wykonaj polecenie z ścieżką do umiejętności: python <ścieżka-do-umiejętności>/scripts/inspect_pr_checks.py --repo "." --pr "<numer-lub-url>". Dodaj flagę --json, jeśli chcesz ustrukturyzowany wynik do dalszej analizy.

4. Przejrzyj podsumowanie błędu i proponowany plan naprawy. Umiejętność wyświetli kontekst awarii oraz konkretne rekomendacje — przeczytaj je uważnie przed podjęciem decyzji.

5. Zatwierdź plan naprawy, aby umiejętność mogła wdrożyć zmiany. Bez Twojej wyraźnej zgody żadne modyfikacje nie będą wprowadzone do kodu.

6. Jeśli dostępna jest umiejętność planowania (np. create-plan), system może jej użyć do bardziej szczegółowego opracowania strategii naprawy — w przeciwnym razie plan zostanie sformułowany bezpośrednio w ramach tej umiejętności.