// Full PR lifecycle: branch, commit, create PR, wait for reviewer comments, fix or pushback, reply, resolve threads, wait for manual merge. Use after completing any code change that should go through review.
| name | pr-review |
| description | Full PR lifecycle: branch, commit, create PR, wait for reviewer comments, fix or pushback, reply, resolve threads, wait for manual merge. Use after completing any code change that should go through review. |
Complete lifecycle for getting code reviewed and merged.
If you're on main, create a feature branch first:
git checkout -b <branch-name>
git add <files>
git commit -m "message"
git push -u origin <branch-name>
gh pr create --title "Title" --body "$(cat <<'EOF'
## Summary
- What changed
## Test plan
- How to verify
🤖 Generated with [Claude Code](https://claude.com/claude-code)
- Claude
EOF
)"
Reviewers (Qodo, Copilot, humans) need time to post comments. Wait 5 minutes after creating the PR before checking.
sleep 300
Check every 1 minute until comments appear:
bash ~/.claude/skills/pr-review/scripts/pr-comments.sh <PR_NUMBER>
If no inline comments found, wait 1 minute and check again. Keep polling until all reviewers have posted (check PR review state), or 10 minutes have passed since PR creation.
For each comment, decide:
Make fixes, commit, push to the same branch:
git add <files>
git commit -m "fix: address review findings"
git push
Reply to every comment thread and resolve it. Use batch mode:
bash ~/.claude/skills/pr-review/scripts/pr-batch.sh --resolve <PR_NUMBER> <<'EOF'
{"comment_id": 123, "body": "Fixed in <sha> — description of fix"}
{"comment_id": 456, "body": "Pushback — reasoning why this is intentional"}
EOF
Sign replies with - Claude.
Never merge PRs yourself. Tell the user the PR is ready and wait for them to squash-merge on GitHub.
Prerequisite: The pr-review scripts must be installed at ~/.claude/skills/pr-review/scripts/ (user-level, shared across repos). These are provided by the global Claude skills setup, not this repo. If missing, the gh api commands in the scripts can be run directly.
| Script | Purpose |
|---|---|
pr-comments.sh <PR> | Fetch all inline review comments with IDs |
pr-reply.sh --resolve <PR> <ID> "body" | Reply to one comment and resolve |
pr-batch.sh --resolve <PR> | Batch reply+resolve from JSONL on stdin |