coderabbit-reviewer

Files (1)

• SKILL.md

SKILL.md (first lines)

# CodeRabbit Reviewer

Processes CodeRabbit automated review feedback and helps address issues. Assumes CodeRabbit is already installed on the repository.

## Prerequisites

- PR created and pushed to GitHub
- CodeRabbit installed on the target repository
- `gh` CLI authenticated
- On the PR branch (auto-checkout below if not)

## Workflow

### 0. Checkout PR Branch (MANDATORY)

**IMPORTANT: Do NOT use `gh api repos/.../contents` or any other remote API to read file contents. Always work from a local checkout. It is faster for multiple file reads, enables grep and broad context checks, and produces more reliable verification.**

You MUST have a local working copy of the PR branch before proceeding to any later step. Check it out:

```bash
# Extract PR info
PR_NUMBER=<N>
REPO_NAME=$(gh pr view "$PR_NUMBER" --json repository --jq '.repository.name // empty' 2>/dev/null \
  || basename "$(gh repo view --json name -q .name)")
BRANCH=$(gh pr view "$PR_NUMBER" --json headRefName -q .headRefName)
```

**Try methods in order:**

```bash
# Method 1: Already on the branch
CURRENT=$(git branch --show-current 2>/dev/null)
if [ "$CURRENT" = "$BRANCH" ]; then
  echo "Already on $BRANCH"

# Method 2: Existing worktree
elif [ -d "${WORKTREE_BASE:-$HOME/worktrees}/$REPO_NAME/$BRANCH" ]; then
  cd "${WORKTREE_BASE:-$HOME/worktrees}/$REPO_NAME/$BRANCH"

# Method 3: Cross-repo task directory
elif ls -d "${CROSS_REPO_BASE:-$HOME/cross-repo-tasks}"/*/"$REPO_NAME" 2>/dev/null | head -1 | grep -q .; then
  cd "$(ls -d "${CROSS_REPO_BASE:-$HOME/cross-repo-tasks}"/*/"$REPO_NAME" 2>/dev/null | head -1)"

# Method 4: wt-continue (branch exists on remote)
else
  wt-continue "$REPO_NAME" "$BRANCH"
  cd "${WORKTREE_BASE:-$HOME/worktrees}/$REPO_NAME/$BRANCH"
fi
```

**Safety checks before syncing:**

```bash
# Abort if uncommitted changes
if [ -n "$(git status --porcelain)" ]; then
  echo "❌ ABORT: Uncommitted changes detected. Stash or commit first."
  git status --short
  exit 1
fi

# Sync with remote
git fetch origin
```

### 1. Verify PR Exists

```bash
PR_NUMBER=$(gh pr view --json number -q '.number')
echo "PR #$PR_NUMBER"
```

### 2. Wait for CodeRabbit Review

CodeRabbit reviews automatically on PR creation. Check for review comment:

```bash
# Check for CodeRabbit review comment
gh pr view $PR_NUMBER --json comments --jq '.comments[] | select(.author.login == "coderabbitai")'
```

Typical wait time: 2-5 minutes for small PRs.

To manually trigger a re-review:

```bash
gh pr comment $PR_NUMBER --body "@coderabbitai review"
```

### 3. Parse Review Feedback

Extract actionable items from CodeRabbit's review:

```markdown
## CodeRabbit Review Summary

### Critical Issues

- [ ] {file:line} - {issue description}

### Suggestions

- [ ] {file:line} - {suggestion}

### Nitpicks

- [ ] {file:line} - {minor improvement}
```

### 4. Categorize by Severity

| Category   | Action Required       | Auto-fixable |
| ---------- | --------------------- | ------------ |
| Critical   | Must fix before merge | Sometimes    |
| Suggestion | Should consider       | Often        |
| Nitpick    | Nice to have          | Usually      |

### 5. Present to User

```

From DrJKL/ticket-to-pr-pipeline, MIT.

More from DrJKL/ticket-to-pr-pipeline