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/