ci-remediation

Files (1)

• SKILL.md

SKILL.md (first lines)

# CI Remediation Skill

Monitor CI runs, fix failing checks, and respond to automated review comments until a PR is ready to merge.

## When to Use

- PR has failing CI checks
- Bug-bot has posted security/quality comments
- Stitch has requested changes
- Need to shepherd a PR through to green CI

## Core Workflow

```
1. Check PR status → gh pr checks
2. Identify failures → Parse check output
3. Fix issues → Edit code, run locally
4. Verify locally → cargo clippy, cargo test, pre-commit
5. Push fixes → git commit && git push
6. Monitor → Loop until all green
```

## Commands

### Check PR Status

```bash
# View all checks with status
gh pr checks

# Detailed status with JSON
gh pr view --json statusCheckRollup,reviews,comments

# Watch checks in real-time
gh pr checks --watch
```

### View Check Logs

```bash
# List workflow runs for PR
gh run list --branch $(git branch --show-current)

# View specific run logs
gh run view <run-id> --log-failed

# Download full logs
gh run view <run-id> --log
```

### Re-run Failed Checks

```bash
# Re-run all failed jobs
gh run rerun <run-id> --failed

# Re-run entire workflow
gh run rerun <run-id>
```

## Common CI Failures

### Clippy (Rust)

```bash
# Run locally with same flags as CI
cargo clippy --all-targets -- -D warnings -W clippy::pedantic

# Fix auto-fixable issues
cargo clippy --fix --allow-dirty
```

**Common fixes:**
- `unused_imports` → Remove unused imports
- `needless_return` → Use implicit return
- `redundant_clone` → Remove `.clone()`
- `missing_docs` → Add doc comments

### Format Check

```bash
# Check formatting
cargo fmt --all --check

# Auto-fix formatting
cargo fmt --all
```

### Test Failures

```bash
# Run all tests
cargo test

# Run specific test with output
cargo test test_name -- --nocapture

# Run tests for specific crate
cargo test -p crate_name
```

### Pre-commit Hooks

```bash
# Run all hooks
pre-commit run --all-files

# Run specific hook
pre-commit run <hook-id> --all-files

# Common hooks: markdownlint, shellcheck, yaml-lint
```

## Responding to Bug-Bot

Bug-bot posts comments about security and quality issues.

### Identifying Bug-Bot Comments

From 5DLabsInc/cto, AGPL-3.0.

More from 5DLabsInc/cto