pr-iteration

Orchestrate end-to-end PR review cycles with external reviews and iterative fixes.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/ctxr-dev/agent-staff-engineer --skill pr-iteration-ctxr-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pr-iteration
Source: https://github.com/ctxr-dev/agent-staff-engineer/tree/main/skills/pr-iteration
Command: npx skills add https://github.com/ctxr-dev/agent-staff-engineer --skill pr-iteration-ctxr-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drives a PR from just opened to a green terminal state by coordinating external reviews, local code changes, and CI checks, while never auto-merging.

Core Features & Use Cases

  • End-to-end PR iteration: orchestrates review requests, CI polling, thread triage, fixes, and final reporting across multiple rounds.
  • Safety gates with human oversight: ensures merges occur only under human approval and surfaces final state to the team.
  • Cross-tool workflow: integrates with GitHub trackers, per-round reporting, and the local review cycle.

Quick Start

Run an end-to-end PR iteration loop on the target PR, requesting external review, monitoring CI, triaging threads, and iterating until all exit conditions are met without auto-merging.

Frequently Asked Questions about pr-iteration

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

FAQPage Schema
How do I automate a GitHub pull request review cycle without auto-merging?

Automating a GitHub pull request review cycle without auto-merging involves orchestrating end-to-end iterations that coordinate external reviews, CI polling, thread triage, and iterative fixes. This workflow drives the PR to a green terminal state while ensuring merges occur only under human approval.

What is the best way to triage code review threads and apply fixes across multiple rounds?

Triageing code review threads and applying fixes across multiple rounds is done through an end-to-end PR iteration loop. This process monitors CI checks, triages review threads, and applies local code changes iteratively until all exit conditions are satisfied.

Can I use GitHub GraphQL integration to track PR review state and generate per-round reports?

Yes, you can use GitHub GraphQL integration to track PR review state and generate per-round reports. This workflow supports GitHub tracker integration and outputs per-round reporting under the `.development/shared/reports` directory for team visibility.

Does this PR iteration workflow support stateful progression for tracking review cycles?

Yes, this PR iteration workflow supports stateful progression for tracking review cycles. It maintains local JSON state under `.development/local/pr-iteration` to track the progression of external reviews, local code changes, and CI checks across multiple rounds.

When should I not use an automated end-to-end PR review orchestration approach?

You should not use automated end-to-end PR review orchestration if your project requires immediate auto-merging upon CI success, as this workflow explicitly avoids auto-merging. It is designed for projects needing human oversight, thread triage, and iterative fixes before final approval.