You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit a57f6b4
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: .agents/skills/iterate-pr/SKILL.md
+18-18Lines changed: 18 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
---
2
2
name: iterate-pr
3
3
description: Iterate on a PR until CI passes. Optionally merge or merge and publish a release of the repo. Automates the feedback-fix-push-wait cycle.
4
-
argument-hint: "[--full] [--release]"
4
+
argument-hint: "[--merge] [--release]"
5
5
metadata:
6
6
author: leecalcote
7
7
version: "2.3.0"
@@ -44,9 +44,9 @@ readability - substitute `uv run` per the rule above whenever `uv` is available.
44
44
Invoke as:
45
45
46
46
-`/iterate-pr`
47
-
-`/iterate-pr --full`
47
+
-`/iterate-pr --merge`
48
48
-`/iterate-pr --release`
49
-
-`/iterate-pr --full --release`
49
+
-`/iterate-pr --merge --release`
50
50
51
51
In Claude Desktop, arguments are **hints**, not strict CLI parsing. Treat whatever follows `/iterate-pr` as a mode hint string.
52
52
@@ -55,16 +55,16 @@ In Claude Desktop, arguments are **hints**, not strict CLI parsing. Treat whatev
55
55
Use this deterministic precedence:
56
56
57
57
1. If hints include `--release` or terms like `release`, `publish`, `ship` → run **release mode**.
58
-
2. Else if hints include `--full` or terms like `full`, `autonomous`, `merge` → run **full mode**.
58
+
2. Else if hints include `--merge` or terms like `autonomous`, `merge` → run **merge mode**.
59
59
3. Else run **default mode**.
60
60
61
61
Do not fail because hints are missing or unrecognized; default safely.
62
62
63
63
| Mode | Behavior |
64
64
|---|---|
65
65
| Default (`/iterate-pr`) | Iterates on CI + high/medium feedback, asks user about low-priority items, then exits without merging. |
66
-
|`--full`| Fully autonomous: handles every non-resolved feedback item, replies to every item, re-requests review (Gemini or Copilot) after each push, iterates until no new feedback and CI is green, then administratively merges the PR without waiting for a required-approval status. |
67
-
|`--release`| Does everything in `--full`, then cuts/publishes a release for the repository. |
66
+
|`--merge`| Fully autonomous: handles every non-resolved feedback item, replies to every item, re-requests review (Gemini or Copilot) after each push, iterates until no new feedback and CI is green, then administratively merges the PR without waiting for a required-approval status. |
67
+
|`--release`| Does everything in `--merge`, then cuts/publishes a release for the repository. |
68
68
69
69
## Bundled Scripts
70
70
@@ -139,7 +139,7 @@ Run `python3 .agents/skills/iterate-pr/scripts/fetch_pr_feedback.py` to get cate
139
139
140
140
### 3. Handle Feedback by Priority and Mode
141
141
142
-
Determine mode from invocation (`/iterate-pr`, `/iterate-pr --full`, `/iterate-pr --release`).
142
+
Determine mode from invocation (`/iterate-pr`, `/iterate-pr --merge`, `/iterate-pr --release`).
143
143
144
144
#### Default mode (`/iterate-pr`)
145
145
@@ -163,7 +163,7 @@ Which would you like to address? (e.g., "1,3" or "all" or "none")
163
163
-`resolved` threads
164
164
-`bot` comments (informational only — Codecov, Dependabot, etc.)
165
165
166
-
#### Full modes (`/iterate-pr --full`, `/iterate-pr --full --release`)
Operate autonomously. Process every non-resolved feedback item returned by `fetch_pr_feedback.py` (`high`, `medium`, `low`, and `bot`).
169
169
@@ -189,12 +189,12 @@ After processing feedback, reply to PR comments/threads to acknowledge the actio
189
189
190
190
**Scope by mode:**
191
191
- Default mode: reply to `high`/`medium`; reply to `low` only when fixed or declined by the user
192
-
-Full modes: reply to every non-resolved feedback item, including informational bot feedback
192
+
-Merge modes: reply to every non-resolved feedback item, including informational bot feedback
193
193
194
194
**How to reply:**
195
195
- If `thread_id` exists (inline review thread), use `python3 .agents/skills/iterate-pr/scripts/reply_to_thread.py`
196
196
- If no `thread_id` exists, post a PR comment with `gh pr comment <PR_NUMBER> --body "..."`
197
-
- In full modes, a feedback round is incomplete until every item has a corresponding reply
197
+
- In merge modes, a feedback round is incomplete until every item has a corresponding reply
198
198
199
199
Batch inline replies for a round into a single call:
200
200
@@ -255,28 +255,28 @@ Poll CI status and review feedback in a loop instead of blocking:
255
255
a. Run `python3 .agents/skills/iterate-pr/scripts/fetch_pr_feedback.py` for new review feedback
256
256
b. Address feedback based on mode:
257
257
- Default mode: new `high`/`medium`
258
-
-Full modes: every new non-resolved item (`high`/`medium`/`low`/`bot`) and reply to each item
258
+
-Merge modes: every new non-resolved item (`high`/`medium`/`low`/`bot`) and reply to each item
259
259
c. If changes were needed, commit and push (this restarts CI)
260
-
d. In full modes, after each push, explicitly re-request review:
260
+
d. In merge modes, after each push, explicitly re-request review:
261
261
- Prefer Gemini review command (`/gemini review`) when available
262
262
- Otherwise request Copilot review by commenting `@copilot review` on the PR
263
263
e. Sleep 30 seconds (don't increase on subsequent iterations), then repeat from sub-step 1
264
264
5. After all checks pass, do a final feedback check: `sleep 10`, then run `python3 .agents/skills/iterate-pr/scripts/fetch_pr_feedback.py`.
265
265
- Default mode: address any new `high`/`medium` feedback; if changes are needed, return to step 6
266
-
-Full modes: address any new non-resolved item; if changes are needed, return to step 6 and re-request review
266
+
-Merge modes: address any new non-resolved item; if changes are needed, return to step 6 and re-request review
267
267
268
268
### 8. Repeat
269
269
270
270
If step 7 required code changes (from new feedback after CI passed), return to step 2 for a fresh cycle. CI failures during monitoring are already handled within step 7's polling loop.
271
271
272
-
In full modes, continue looping until both conditions are true:
272
+
In merge modes, continue looping until both conditions are true:
273
273
- CI checks are green
274
274
- No new non-resolved feedback is returned after the latest review request
275
275
276
276
### 9. Finish by Mode
277
277
278
278
- Default mode: stop after success conditions are met (do not merge automatically)
279
-
-`full`: once CI is green and no new feedback remains, merge administratively - do not wait for a required-approval status to clear:
279
+
-`merge`: once CI is green and no new feedback remains, merge administratively - do not wait for a required-approval status to clear:
280
280
281
281
```bash
282
282
gh pr merge <PR_NUMBER> --admin --delete-branch
@@ -290,7 +290,7 @@ authenticated account lacks admin/maintainer rights on the repo, or a check can'
290
290
bypassed), stop and surface the `gh` error to the user - do not retry under a different
291
291
identity and do not fall back silently.
292
292
293
-
-`--release`: complete `--full` mode merge, then cut a release:
293
+
-`--release`: complete `--merge` mode merge, then cut a release:
@@ -308,9 +308,9 @@ identity and do not fall back silently.
308
308
309
309
**Success (default):** All checks pass, post-CI feedback re-check is clean (no new unaddressed high/medium feedback including review bot findings), user has decided on low-priority items.
310
310
311
-
**Success (`full`):** All checks pass, no new non-resolved feedback remains after the latest review request, every feedback item has a reply, and the PR is administratively merged (no wait on a required-approval status).
311
+
**Success (`merge`):** All checks pass, no new non-resolved feedback remains after the latest review request, every feedback item has a reply, and the PR is administratively merged (no wait on a required-approval status).
312
312
313
-
**Success (`--release`):**`--full` success criteria are met and the draft GitHub release has been published.
313
+
**Success (`--release`):**`--merge` success criteria are met and the draft GitHub release has been published.
314
314
315
315
**Ask for help:** Same failure after 2 attempts, feedback needs clarification, infrastructure issues, or `gh pr merge --admin` fails (insufficient permissions or an unbypassable check) - surface the error rather than retrying under a different identity or falling back silently.
0 commit comments