Fix CI Failures Skill

Diagnose and fix CI/CD failures systematically.

When to Use

• CI checks fail on PR
• Workflow runs fail
• Tests pass locally but fail in CI
• Need to debug CI issues

Diagnosis Workflow

1. Check CI Status

# View PR checks
gh pr checks <pr-number>

# View specific run
gh run view <run-id>

# Get failed logs
gh run view <run-id> --log-failed

2. Identify Failure

# Download logs
gh run download <run-id>

# Or view online
gh run view <run-id> --web

3. Reproduce Locally

# Run same commands as CI
./scripts/reproduce_ci.sh <run-id>

Common Failures

1. Pre-commit Failures

Trailing whitespace....Failed

Fix:

pre-commit run --all-files
git add .
git commit --amend --no-edit
git push --force-with-lease

2. Test Failures

test_tensor_add....FAILED

Fix:

# Run tests locally
mojo test tests/

# Fix failing test
# Re-run to verify
# Push fix

3. Linting Failures

Markdown lint....Failed

Fix:

npx markdownlint-cli2 --fix "**/*.md"
git add .
git commit -m "fix: markdown linting"
git push

4. Build Failures

Error: Cannot find module

Fix:

# Check dependencies
# Update imports
# Re-build locally
# Push fix

Fixing Workflow

# 1. Get failure logs
./scripts/get_ci_logs.sh <pr-number>

# 2. Reproduce locally
./scripts/reproduce_ci_failure.sh

# 3. Fix issue
# ... make changes ...

# 4. Verify fix
./scripts/run_ci_locally.sh

# 5. Push fix
git add .
git commit -m "fix: address CI failure"
git push

# 6. Verify CI passes
gh pr checks <pr-number> --watch

Scripts

• scripts/get_ci_logs.sh - Download CI logs
• scripts/reproduce_ci_failure.sh - Reproduce locally
• scripts/run_ci_locally.sh - Run CI checks locally
• scripts/fix_common_ci_issues.sh - Auto-fix common issues

Prevention

• Run pre-commit before pushing
• Run tests locally
• Check formatting
• Review CI logs regularly

See .github/workflows/ for workflow definitions.