pr-review-loop

Repeats deep review and root-cause fixes on branch diffs until findings converge.

Updated Oct 14, 2024
One-click install
npx skills add https://github.com/tktcorporation/food-shop-search --skill pr-review-loop-tktcorporation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-review-loop
Source: https://github.com/tktcorporation/food-shop-search/tree/main/.claude/skills/pr-review-loop
Command: npx skills add https://github.com/tktcorporation/food-shop-search --skill pr-review-loop-tktcorporation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before creating a pull request, a single review-and-fix pass often leaves residual issues or produces shallow local patches. This Skill automates an iterative loop of deep review and root-cause correction on your local branch diff until no findings remain, so the PR is genuinely ready. ## Core Features & Use Cases - Iterative Review-Fix Loop: Runs pr-deep-review style reviews each round via a dedicated subagent or codex review, then applies upstream-fix root-cause analysis across all findings until convergence. - Cluster-Based Diagnosis: Groups findings by shared design root causes (responsibility placement, normalization gaps, ambiguous contracts) and fixes each cluster as one coherent change rather than scattered patches. - Convergence Gating: Records each round's finding count via a hook script, supports semantic mid-loop convergence with user acceptance, and enforces round limits with explicit user confirmation. - Use Case: Before running gh pr create, ask the AI to loop review and fixes on your branch; it reviews the diff against origin/main, fixes root causes round by round, and reports a per-round summary with a readiness verdict. ## Quick Start Ask the AI to review and fix the current branch diff repeatedly until no findings remain before creating the pull request.

Frequently Asked Questions about pr-review-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review and fix my branch repeatedly before creating a PR?▼

Run this loop on your local branch diff against origin/main. Each round launches a deep review, clusters findings by root cause, applies upstream fixes, commits, and repeats until no findings remain or the user accepts the residual ones.

What is the difference between a single deep review and a review-fix loop?▼

A single deep review produces one list of findings without fixing them. The loop applies root-cause fixes after each review and re-reviews the updated diff, repeating until findings converge, which satisfies the pre-PR gate.

Can I use codex review instead of a subagent for each round?▼

Yes, codex review with a base branch can replace the subagent review, and the round is recorded with a codex flag. The final converging round is expected to use codex review per the self-review rule.

What happens if the review findings never reach zero?▼

If findings point to the same root cause as the previous round, the loop treats it as semantic convergence and asks the user to accept the remaining findings. Accepted findings are recorded honestly and must be documented in the PR body.

Is there a limit on how many review rounds run automatically?▼

Yes, the default cap is five rounds. When the limit is reached, the loop asks the user whether to continue, reporting the finding-count trend and why convergence has not been achieved.