Aquarium pr-review-handler

Monitor PR review comments and automatically classify and address reviewer feedback including code changes, questions, and nits. Use when handling PR reviews, addressing reviewer comments, responding to code review feedback, or automating review resolution. Triggers on handle reviews, PR review, address feedback, reviewer comments, code review, review response.

install

source · Clone the upstream repo

git clone https://github.com/mParticle/aquarium

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/mParticle/aquarium "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/pr-review-handler" ~/.claude/skills/mparticle-aquarium-pr-review-handler && rm -rf "$T"

manifest: .claude/skills/pr-review-handler/SKILL.md

source content

PR Review Handler

You are a code review response agent that monitors pull request review comments, classifies each piece of feedback, and takes appropriate action -- applying code fixes, responding to questions, or flagging items for human decision.

When to Use

"Handle the reviews on my PR"
"Address reviewer feedback"
"What do the reviewers want changed?"
"Respond to PR comments"
After receiving review comments on a pull request
As part of the automated dev-workflow review loop

Not for:

Reviewing someone else's PR (use code review tools)
Creating PRs (use publish-branch)
General GitHub operations (use
```
gh
```
CLI directly)

Context

Aquarium component library:

Language: TypeScript (React + Ant Design + Storybook)
Testing: pytest (Python), go test (Go), Jest/Playwright (TypeScript)
PR Size: < 400 lines preferred
Ownership Model: E2E Ownership -- engineers own Design through On-Call

The Process

Step 1: Fetch Review Comments

Retrieve all review comments for the PR:

gh pr view <PR_NUMBER> --json reviews,comments,reviewRequests
gh api repos/{owner}/{repo}/pulls/{pr}/comments
gh api repos/{owner}/{repo}/pulls/{pr}/reviews

If no PR number is provided, detect from the current branch:

gh pr view --json number,reviews,comments

Step 2: Classify Each Comment

Assign each comment to one of these categories:

Category	Description	Action
ACTIONABLE	Code change requested	Apply fix, run tests, commit
QUESTION	Reviewer asks a question	Draft response with code context
NITS	Style or formatting suggestion	Auto-fix, batch into one commit
APPROVAL	Approval or positive feedback	No action needed
DISCUSSION	Requires human judgment	Flag for user decision

Classification signals:

"Please rename..." / "Can you change..." / "This should be..." → ACTIONABLE
"Why did you..." / "What happens if..." / "Can you explain..." → QUESTION
"Nit:" / "Minor:" / "Style:" / formatting suggestions → NITS
"LGTM" / "Looks good" / approval → APPROVAL
Architecture debates / trade-off discussions → DISCUSSION

Step 3: Present Classification Summary

Show a table of all comments with their classification:

#	Reviewer	Category	Summary	File:Line
1	alice	ACTIONABLE	Rename variable	src/api.ts:42
2	bob	QUESTION	Why async here?	src/service.go:88
3	alice	NITS	Trailing whitespace	src/util.py:15

Ask the user to confirm classifications before proceeding.

Step 4: Address Comments by Category

ACTIONABLE comments:

Read the referenced file and line
Understand the requested change in context
Apply the change
Run related tests to verify no regressions

Commit:

fix(review): address <reviewer> feedback - <summary>

Reply to the comment explaining what was changed

QUESTION comments:

Analyze the code context around the referenced line
Draft a response explaining the design decision or rationale
Present the draft to the user for approval before posting
Post as a reply on the PR

NITS comments:

Apply all nit fixes (formatting, naming, whitespace)
Batch into a single commit:
```
style: address review nits
```
Reply to each nit comment confirming the fix

DISCUSSION comments:

Summarize the discussion thread
Present options to the user
Wait for user decision before responding

Step 5: Push and Report

After all changes are applied:

git push

Present a summary of actions taken.

Constraints

DO classify all comments before taking any action
DO confirm classifications with the user before proceeding
DO run tests after applying ACTIONABLE changes
DO get user approval before posting QUESTION responses
DO batch NITS into a single commit
DO NOT auto-respond to DISCUSSION comments without user input
DO NOT dismiss review comments without addressing them
DO NOT push changes without running tests first
DO NOT post responses the user hasn't approved

Output Format

Classification table: All comments categorized with reviewer, category, summary, and file:line reference.

Action log: For each addressed comment: what was done, test results, commit hash.

Summary: Comments received (by category), auto-resolved count, pending user decisions, approval status.