Address Review
Testing & Qualityaddress-reviewAddress Review is an Agent Skill for testing & quality published in the saffron-health/libretto repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Address PR review comments systematically. Use when responding to code review feedback on a pull request.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/saffron-health/libretto/blob/HEAD/.agents/skills/address-review/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/address-review, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Address PR review comments systematically.
Process
-
Get review comments: Use
gh api graphqlto fetch all review threads and comments for the PR. (If a PR number is not provided in the input, look up the PR for the current branch). -
Analyze comments: Review all the feedback to understand what changes are needed
-
Address each comment systematically: For each review comment:
- Make the requested code changes
- Verify the changes fix the issue raised
- Add explanatory comments if the reviewer requested clarification
- Test changes to ensure they don't break existing functionality
-
Quality assurance: Run type-check, build, and lint to ensure all changes are correct
-
Commit and push: Stage and commit all changes with an appropriate message and push.
-
Mark comments resolved: Query PR review threads with
gh api graphqlto get thread IDs and outdated status. Resolve all addressed threads usingmutation { resolveReviewThread(input: {threadId: "THREAD_ID"}) { thread { isResolved } } }. Always resolve outdated threads.
Implementation Pattern
// Query review threads:
gh api graphql -f query='query { repository(owner: "owner", name: "repo") { pullRequest(number: N) { reviewThreads(first: 100) { nodes { id isResolved isOutdated comments { nodes { body } } } } } } }'
// Resolve thread:
gh api graphql -f query='mutation { resolveReviewThread(input: {threadId: "THREAD_ID"}) { thread { isResolved } } }'
Notes
- Only address reviews from human users; ignore bot reviews (e.g., Claude) unless explicitly requested
- Use sub-agents to handle independent review comments in parallel when possible
- Always verify changes don't introduce new issues
- If a review comment requires clarification, document the approach taken
- Focus on the specific issues raised rather than making additional changes
- Mark outdated comments as resolved automatically since they no longer apply to current code