fix-ci

Detect the current branch's pull request, retrieve its failing CI workflow logs, fix the root causes, commit, and push. This command auto-detects the PR from the current Git branch, fetches check run statuses, downloads failure logs, classifies each failure, implements fixes, and pushes a single commit.

For commit conventions, refer to the Git Flow rule. For lint verification, refer to the CI/CD rule.

Pre-flight

Step 1 -- Verify GitHub CLI authentication

gh auth status

If this fails, report the error and stop. The gh CLI must be installed and authenticated.

Step 2 -- Detect repository context

gh repo view --json nameWithOwner -q '.nameWithOwner'

Split the result into {owner} and {repo}.

Step 3 -- Auto-detect PR from current branch

gh pr view --json number,headRefName -q '.number'

This returns the PR number associated with the current branch. If it fails (no PR exists for the current branch), report: "No pull request found for the current branch. Switch to a branch with an open PR or create one first." and stop.

Store the returned number as {PR_NUMBER}. Then ensure the local branch is up to date:

git pull --rebase

Procedure

Step 4 -- Fetch check run statuses

List all check runs for the PR and identify failures:

gh pr checks {PR_NUMBER}

Filter to checks with fail status. If no failing checks exist, report "All CI checks are passing on PR #{PR_NUMBER}." and stop.

Step 5 -- Retrieve failure logs

For each failing check, retrieve the workflow run ID and job ID from the check URL, then download the failed job logs:

gh run view {RUN_ID} --job {JOB_ID} --log-failed

If the log output is very large, use tail -100 to focus on the error section. Extract:

• The specific error messages and file/line references
• The tool or stage that failed (e.g., golangci-lint, make test, basic-checks)
• Whether the failure is in code you can fix or an infrastructure/flaky issue