gh-process-review

# GitHub Review Processing

Process PR review threads efficiently by storing them locally and addressing them one by one.

## CRITICAL: Run from project directory

**NEVER `cd` into the skill directory.** All scripts must be called from the project root using the full skill path. The scripts need access to the git repo and `gh` CLI context.

`SKILL_DIR` = directory containing this SKILL.md

## Initial Setup (run automatically)

Fetch reviews for current PR and list unresolved threads:

```bash
REVIEWS_FILE=$("$SKILL_DIR/scripts/fetch_reviews.sh" "$(! gh pr view --json number -q .number)")
"$SKILL_DIR/scripts/list_unresolved.sh" "$REVIEWS_FILE"
```

### Continue mode (`/gh-process-review continue`)

Skip fetching, use existing reviews file for current branch's PR:

```bash
REVIEWS_FILE=".scratch/reviews/$(! gh repo view --json owner,name -q '"\(.owner.login)-\(.name)"')-pr-$(! gh pr view --json number -q .number).json"
"$SKILL_DIR/scripts/list_unresolved.sh" "$REVIEWS_FILE"
```

## Workflow

1. **For each unresolved thread**:
   - Get thread details with `"$SKILL_DIR/scripts/get_thread.sh" "$REVIEWS_FILE" PRRT_...`
   - Read the relevant file and understand the feedback
   - Implement the fix
   - Commit with message referencing the review
   - Push the commit
   - Reply with commit hash: `"$SKILL_DIR/scripts/reply_with_commit.sh" "$REVIEWS_FILE" PRRT_...`
   - Mark resolved with `"$SKILL_DIR/scripts/mark_resolved.sh" "$REVIEWS_FILE" PRRT_...`
2. **Repeat** until all threads addressed

## Scripts

All scripts in `$SKILL_DIR/scripts/`. Call with full path from project directory. Use these instead of inline bash for auto-allow capability.

### fetch_reviews.sh
```bash
# Usage: "$SKILL_DIR/scripts/fetch_reviews.sh" <pr-url-or-number> [output-dir]
# Examples:
"$SKILL_DIR/scripts/fetch_reviews.sh" "$(! gh pr view --json number -q .number)"  # Current PR
"$SKILL_DIR/scripts/fetch_reviews.sh" 123
"$SKILL_DIR/scripts/fetch_reviews.sh" https://github.com/owner/repo/pull/123
`