Iterate on PR Until CI Passes

Goal: fix actionable CI failures and high/medium review feedback. Stop and report human approval, draft-readiness, and merge-readiness gates.

Requires:

• authenticated gh
• uv
• target repository root as cwd
• skill-root-relative script paths, for example scripts/fetch_pr_checks.py

Bundled Scripts

Script	Run	Output
scripts/fetch_pr_checks.py	uv run scripts/fetch_pr_checks.py [--pr NUMBER]	JSON: pr, summary, checks, failure snippets
scripts/fetch_pr_feedback.py	uv run scripts/fetch_pr_feedback.py [--pr NUMBER]	JSON buckets: high, medium, low, bot, resolved
scripts/monitor_pr_checks.py	uv run scripts/monitor_pr_checks.py [--pr NUMBER]	terminal marker plus tab-separated checks
scripts/reply_to_thread.py	uv run scripts/reply_to_thread.py THREAD_ID BODY [...]	JSON reply results

Check summary fields include failed, pending, actionable_pending, and human_gate_pending.

Monitor markers:

• ALL_CHECKS_PASSED
• CHECKS_DONE_WITH_FAILURES
• NO_CHECKS_REGISTERED
• DRAFT_PR_WITH_NO_CHECKS
• CHECKS_BLOCKED_BY_REVIEW_GATE

Workflow

1. Identify PR

Run:

gh pr view --json number,url,headRefName,isDraft,reviewDecision

Stop when:

• no PR exists
• draft PR has no checks after monitor grace period: report DRAFT_PR_WITH_NO_CHECKS

Draft rule: inspect existing checks/feedback only. Do not mark ready for review unless asked.

2. Handle Feedback

Run uv run scripts/fetch_pr_feedback.py [--pr NUMBER].

Bucket	Action
high	fix
medium	fix
low	ask user which to address
bot	skip informational comments
resolved	skip

Feedback fix checklist:

• verify root cause
• search related code
• fix all instances
• for review_bot: true: fix real issues, explain false positives