PR review comments → fixes → quality gates → resolved threads → updated PR. /resolve-review [N].
1. Identify the PR
gh pr view --json number,title,url,headRefName # current branch
gh pr view <number> --json number,title,url,headRefName,baseRefName # specific PR
gh repo view --json nameWithOwner --jq '.nameWithOwner' # for below
2. Fetch review comments
gh api repos/{owner}/{repo}/pulls/<number>/comments \
--jq '[.[] | {id, path, line, body, resolved: false, author: .user.login}]' # inline
gh pr view <number> --json reviews \
--jq '.reviews[] | select(.state == "CHANGES_REQUESTED") | {author: .author.login, body: .body}'
gh api repos/{owner}/{repo}/issues/<number>/comments \
--jq '[.[] | {id, body, author: .user.login}]' # general
Group by file/theme; list before touching code. Skip unclear ones.
3. Implement & commit — scope each change to its comment, read the file first
git commit -m "fix: <short description> (review comment #<comment-id>)"
4. Quality gates & rebase
npx tsc --noEmit && npm run lint && npm test
git fetch origin && git merge-base --is-ancestor origin/<base-branch> HEAD || git rebase origin/<base-branch>
Never push if a gate fails or conflicts remain.
5. Push & resolve threads
git push origin HEAD
gh api repos/{owner}/{repo}/pulls/<number>/comments/<comment-id>/replies \
-X POST -f body="Addressed in <commit-sha> — <one-line explanation>"
gh api repos/{owner}/{repo}/pulls/<number>/reviews \
-X POST -f body="All CHANGES_REQUESTED items addressed." -f event="COMMENT"
6. Update the PR description
CURRENT_BODY=$(gh pr view <number> --json body --jq '.body')
gh pr edit <number> --body "$(cat <<'EOF'
${CURRENT_BODY}
---
## Review response
| # | Comment | Resolution |
|---|---------|------------|
| 1 | @author: "..." | Fixed in <sha> |
EOF
)"
Edge cases: No open PR → ask for a number. Already resolved → skip. Design change → flag. Draft PR → push, tell user to un-draft. Resolve only fixed threads. See REFERENCE.md for language-specific quality gate commands and gh API pagination.