| name | GitHub CI Fix Debugging |
| description | Debug and fix failing GitHub PR checks by inspecting GitHub Actions logs, summarizing failure context, drafting fix plans, and implementing fixes after approval. |
| version | 1.0.0 |
| author | openai |
| license | MIT |
| tags | ["github-actions","ci","debugging","pr-checks","fix"] |
| testingTypes | ["integration"] |
| frameworks | ["github-actions"] |
| languages | ["yaml","typescript","javascript","python"] |
| domains | ["devops"] |
| agents | ["claude-code","cursor","github-copilot","windsurf","codex","aider","continue","cline","zed","bolt"] |
GitHub CI Fix Debugging
Use gh CLI to locate failing PR checks, fetch GitHub Actions logs for actionable failures, summarize the failure, propose a fix plan, and implement after explicit approval.
Prerequisites
Authenticate with the GitHub CLI:
gh auth login
gh auth status
Workflow
1. Verify Authentication
gh auth status
If unauthenticated, ask the user to run gh auth login with repo + workflow scopes.
2. Resolve the PR
gh pr view --json number,url
gh pr checks <pr-number>
3. Inspect Failing Checks
gh pr checks <pr> --json name,state,bucket,link,startedAt,completedAt,workflow
gh run view <run_id> --json name,workflowName,conclusion,status,url
gh run view <run_id> --log
4. Scope Non-GitHub Actions Checks
- If
detailsUrl is not a GitHub Actions run, label it as external
- Only report the URL for external providers (Buildkite, etc.)
5. Summarize Failures
For each failing check, provide:
- The failing check name
- The run URL
- A concise log snippet showing the actual failure
- Root cause analysis
6. Create a Fix Plan
Draft a concise plan including:
- What failed and why
- Proposed fix with specific file changes
- Impact assessment
- Request explicit approval before implementing
7. Implement After Approval
- Apply the approved plan
- Summarize diffs and changes made
- Run relevant tests locally if possible
8. Recheck Status
