review-comments

Address Review Comments

Select and independently validate PR feedback before making focused local changes. This skill owns only the attended local phase: selection, validation, edits, tests, and a local commit. It never publishes a branch, GitHub reply, or thread resolution. /reply-comments owns those separately confirmed remote actions.

Usage

/review-comments                         # PR for the current branch
/review-comments 123                     # backward-compatible current-repository selector
/review-comments owner/repo#123          # repository-qualified selector from the watcher
/review-comments owner/repo#123 inline:C1 conversation:I2

Trailing stable identities preselect candidates but never authorize an edit or reply.

Instructions

1. Resolve the PR and Checkout

Accept owner/repo#number or a numeric PR. With no selector, resolve the current branch through:

~/.agents/skills/review-comments/scripts/gh-pr-current-info.sh

For a numeric selector, derive owner/repository from the current checkout. For a repository-qualified selector, use its owner/repository for every GitHub call. Fetch PR metadata, head SHA, branch, body, and changed files read-only.

Before offering a local fix, prove that the current directory is a matching checkout:

1. origin resolves to the selected owner/repository;
2. the current branch/HEAD represents the selected PR head;
3. the working tree's pre-existing changes are understood and will not be overwritten.

Never switch branches, create a checkout, fetch, reset, clean, or overwrite unrelated work. If no matching checkout exists, validation and reply preparation may continue from the PR diff, but local fix actions are unavailable. Tell the user which checkout is required.

2. Fetch the Normalized Inventory

Use one bounded read-only call:

~/.agents/skills/pr-status/scripts/gh-pr-feedback.py {owner} {repo} {pr_number}

Read records, partial, and errors. Preserve each candidate's stable identity, updatedAt, updateKey, stateKey, source, lifecycle, author kind, and targets throughout the run. Never use body text or counts as identity. Pending draft review comments are not observable and must not be invented.