/coderabbit-review

name: coderabbit-review
description: |
  Unified CodeRabbit CLI execution via WSL with self-healing loop.
  Use this skill when running automated code review before commits, PRs, or QA gates.
  Handles WSL wrapper, severity filtering, and auto-fix iterations.
user-invocable: true
argument-hint: "[scope: uncommitted|committed|base]"

CodeRabbit Review

Centralized CodeRabbit CLI execution for automated code review via WSL.

Prerequisites

• CodeRabbit CLI installed in WSL at `~/.local/bin/coderabbit`
• WSL distribution: Ubuntu
• Authenticated: `wsl bash -c '~/.local/bin/coderabbit auth status'`

Execution

1. Determine Scope

Parse `$ARGUMENTS` to determine review scope:

| Argument | Command | Use Case | |----------|---------|----------| | `uncommitted` (default) | `--prompt-only -t uncommitted` | Pre-commit review | | `committed` | `--prompt-only -t committed --base main` | QA story review | | `base {branch}` | `--prompt-only --base {branch}` | Pre-PR review against specific base |

2. Build WSL Command

wsl bash -c 'cd /mnt/c/path/to/aiox-core && ~/.local/bin/coderabbit {flags}'

**Timeout:** 15 minutes (900000ms) — CodeRabbit reviews take 7-30 min.

3. Execute Review

Run the command via Bash tool with appropriate timeout.

4. Parse Results

Classify findings by severity:

| Severity | Action | |----------|--------| | **CRITICAL** | Must fix immediately — blocks completion | | **HIGH** | Recommend fix before merge | | **MEDIUM** | Document as technical debt | | **LOW** | Optional improvement, note only |

5. Self-Healing Loop (if CRITICAL found)

iteration = 0
max_iterations = agent-specific (dev: 2, qa: 3, devops: 2)

WHILE iteration < max_iterations AND critical_issues_remain:
  1. Attempt auto-fix for each CRITICAL issue
  2. Re-run CodeRabbit review
  3. iteration++

IF critical_issues_remain after max_iterations:
  HALT and report to user

6. Report

Output a summary table:

## CodeRabbit Review Results

| Severity | Count | Status |
|----------|-------|--------|
| CRITICAL | N | Fixed/Remaining |
| HIGH | N | Documented |
| MEDIUM | N | Tech debt |
| LOW | N | Noted |

**Decision:** PASS / FAIL

Error Handling

| Error | Cause | Resolution | |-------|-------|------------| | `coderabbit: command not found` | Not installed in WSL | `wsl bash -c 'pip install coderabbit-cli'` | | Timeout (>15 min) | Large review | Increase timeout, review is still processing | | `not authenticated` | Auth expired | `wsl bash -c '~/.local/bin/coderabbit auth status'` |

Agent-Specific Configuration

| Agent | Max Iterations | Severity Filter | Trigger | |-------|---------------|-----------------|---------| | @dev | 2 | CRITICAL only | Pre-commit (story completion) | | @qa | 3 | CRITICAL + HIGH | Story review start | | @devops | 2 | CRITICAL + HIGH | Pre-push / Pre-PR |

Report Location

Save reports to: `docs/qa/coderabbit-reports/`