mcpField
R
review-pr-thread-verify

review-pr-thread-verify

github.com/doodledoodTesting & quality78102 installsUpdated 1d ago
Repository

About review-pr-thread-verify

A skill for assessing what has happened to a review finding on a pull request. It weighs the original concern against relevant code changes, replies, and thread history, then returns a disposition and, when needed, a draft response.

Key features

  1. 01Compares the concern with relevant code changes
  2. 02Evaluates replies and thread history
  3. 03Returns one of five dispositions
  4. 04Drafts a response when warranted
  5. 05Includes recommendation context for judgment findings

Use cases

  1. 01Check whether a review concern was fixed
  2. 02Assess whether an author reply answers a finding
  3. 03Draft a focused follow-up on an unresolved concern

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/doodledood/manifest-dev --skill review-pr-thread-verify

After installing, type/review-pr-thread-verifyin Claude Code to confirm it loaded.

Details

From the project README

review-pr-thread-verify

Decide what has happened to one review finding since we posted it. The caller hands over everything; this skill judges and returns, and never posts, resolves, or edits anything itself.

Receives. The original finding (its anchor, body, the commit or head SHA it was reviewed at, and the concrete concern it raised); whether the thread is resolved, and by whom; every author reply on the thread since our last message, plus every prior reply we posted there; the current code at the anchor with nearby context, and any commits since the original review that touched the relevant range; the full PR history (all comments, review threads, commit messages, the current PR description, our prior review and comment bodies); bundle context for each linked PR (diff, description, top-level conversation); for judgment threads, the relevant project direction, decisions and prior recommendation with its grounds; and the caller's voice profile — its rules for how a posted comment reads — to apply to any reply drafted here.

Judges. Read the concrete concern first and hold it fixed: the question is whether that failure mode is gone, conceded, disproven, or still live — not whether the thread has been discussed. A code change counts only when it touches the relevant range and removes the failure mode; a reply counts only when a fair-minded human reviewer would concede it. Push back only on new signal — a new author reply, a code change, or someone else resolving the thread before we pushed back on it — and stay on the specific point under contention; never repeat an argument already made on the thread. A resolution is not a fix: when someone else resolved the thread and neither a fix nor a reply answers the concern, it still stands. A resolution after our pushback, with no new reply or fix, is no new signal: the concern stands and our argument is already there.

For a judgment finding, apply ../review-pr-judgment/SKILL.md → What answers a concern. A settled trade-off is not necessarily a refuted concern or a favorable recommendation. Return the current recommendation and its grounds alongside the discussion's disposition; an acknowledgment preserves a remaining disagreement without repeating the argument.

Returns exactly one disposition:

  • addressed-by-fix — A commit after our review modified the relevant code and removes the concrete failure mode. Straightforward code fixes need no reply unless there was active discussion to answer; draft one only then.
  • addressed-by-valid-reply — The author replied on this or another thread with an argument a fair-minded human reviewer would concede: correct factual context, an informed trade-off accepted by the applicable authority, a valid out-of-scope boundary, or code elsewhere already covering the concern. Draft a short concession or acknowledgment.
  • false-positive-or-stale — Our comment was wrong, stale, or is disproven by current PR history. Draft a brief correction that owns the miss.
  • needs-our-pushback — The author replied, changed code, or someone else resolved the thread, but the concrete concern remains. Draft a short reply for the existing thread on that specific point.
  • still-pending — No relevant new author reply and no relevant code change since our last look, and the thread is either unresolved or resolved again after our pushback. Draft nothing.

Return shape. The disposition name, one short reason (the evidence: the commit, the reply, or the absence of either), and the drafted reply text when the disposition calls for one, written in the supplied voice profile. For judgment, also return the current recommendation, its grounds and whether the discussion is settled.

Comments

Markdown supported