Revise a SPEC or EPIC PR based on review feedback and push an update. Use when a routine fires on a PR being labelled `ai:revise-now`, or when a user asks to "revise spec PR #NNN" / "revise epic PR #NNN" interactively. Non-interactive — reads every unresolved review comment + inline comment + the current SPEC/EPIC file, rewrites it, pushes to the same branch, and posts a one-line summary comment pointing at the diff.
88
90%
Does it follow best practices?
Impact
81%
1.47xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
A spec pull request for a real-time notification service (PR #42) has received a batch of review comments and needs to be revised. The PR is on branch claude/spec-042-notifications. The review includes a mix of concrete change requests, a question about ownership, an out-of-scope suggestion, and a schema addition from the top-level review.
The revision should carefully address each comment according to its nature and update the spec accordingly, then document what was done.
The input files are provided under inputs/:
inputs/SPEC-042-notifications.md — the current spec fileinputs/review_comments.json — the review comments on the PR (structured data representing what would be fetched from GitHub), including metadata about when the last revise commit was madeProduce the following files in your working directory:
SPEC-042-notifications-revised.md — the updated spec with all appropriate changes appliedrevision_plan.md — a structured document that for each comment states:
pr_comment_summary.md — the text of the top-level PR comment you would post, summarising the round (how many comments addressed, deferred, replied-to; link placeholder; open questions remaining)per_comment_replies.md — the reply text you would post on each individual commentWork only from the files in inputs/. Do not make up additional context beyond what is provided.