Skip to content

Commit a57f6b4

Browse files
authored
Merge pull request #1763 from layer5io/fm/iterate-pr-rename
chore(skills): hard-rename iterate-pr --full mode to --merge
2 parents 1d2a31c + 6d433d3 commit a57f6b4

1 file changed

Lines changed: 18 additions & 18 deletions

File tree

‎.agents/skills/iterate-pr/SKILL.md‎

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: iterate-pr
33
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]"
55
metadata:
66
author: leecalcote
77
version: "2.3.0"
@@ -44,9 +44,9 @@ readability - substitute `uv run` per the rule above whenever `uv` is available.
4444
Invoke as:
4545

4646
- `/iterate-pr`
47-
- `/iterate-pr --full`
47+
- `/iterate-pr --merge`
4848
- `/iterate-pr --release`
49-
- `/iterate-pr --full --release`
49+
- `/iterate-pr --merge --release`
5050

5151
In Claude Desktop, arguments are **hints**, not strict CLI parsing. Treat whatever follows `/iterate-pr` as a mode hint string.
5252

@@ -55,16 +55,16 @@ In Claude Desktop, arguments are **hints**, not strict CLI parsing. Treat whatev
5555
Use this deterministic precedence:
5656

5757
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**.
5959
3. Else run **default mode**.
6060

6161
Do not fail because hints are missing or unrecognized; default safely.
6262

6363
| Mode | Behavior |
6464
|---|---|
6565
| 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. |
6868

6969
## Bundled Scripts
7070

@@ -139,7 +139,7 @@ Run `python3 .agents/skills/iterate-pr/scripts/fetch_pr_feedback.py` to get cate
139139

140140
### 3. Handle Feedback by Priority and Mode
141141

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`).
143143

144144
#### Default mode (`/iterate-pr`)
145145

@@ -163,7 +163,7 @@ Which would you like to address? (e.g., "1,3" or "all" or "none")
163163
- `resolved` threads
164164
- `bot` comments (informational only — Codecov, Dependabot, etc.)
165165

166-
#### Full modes (`/iterate-pr --full`, `/iterate-pr --full --release`)
166+
#### Merge modes (`/iterate-pr --merge`, `/iterate-pr --merge --release`)
167167

168168
Operate autonomously. Process every non-resolved feedback item returned by `fetch_pr_feedback.py` (`high`, `medium`, `low`, and `bot`).
169169

@@ -189,12 +189,12 @@ After processing feedback, reply to PR comments/threads to acknowledge the actio
189189

190190
**Scope by mode:**
191191
- 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
193193

194194
**How to reply:**
195195
- If `thread_id` exists (inline review thread), use `python3 .agents/skills/iterate-pr/scripts/reply_to_thread.py`
196196
- 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
198198

199199
Batch inline replies for a round into a single call:
200200

@@ -255,28 +255,28 @@ Poll CI status and review feedback in a loop instead of blocking:
255255
a. Run `python3 .agents/skills/iterate-pr/scripts/fetch_pr_feedback.py` for new review feedback
256256
b. Address feedback based on mode:
257257
- 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
259259
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:
261261
- Prefer Gemini review command (`/gemini review`) when available
262262
- Otherwise request Copilot review by commenting `@copilot review` on the PR
263263
e. Sleep 30 seconds (don't increase on subsequent iterations), then repeat from sub-step 1
264264
5. After all checks pass, do a final feedback check: `sleep 10`, then run `python3 .agents/skills/iterate-pr/scripts/fetch_pr_feedback.py`.
265265
- 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
267267

268268
### 8. Repeat
269269

270270
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.
271271

272-
In full modes, continue looping until both conditions are true:
272+
In merge modes, continue looping until both conditions are true:
273273
- CI checks are green
274274
- No new non-resolved feedback is returned after the latest review request
275275

276276
### 9. Finish by Mode
277277

278278
- 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:
280280

281281
```bash
282282
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'
290290
bypassed), stop and surface the `gh` error to the user - do not retry under a different
291291
identity and do not fall back silently.
292292

293-
- `--release`: complete `--full` mode merge, then cut a release:
293+
- `--release`: complete `--merge` mode merge, then cut a release:
294294
1. Find the draft release tag:
295295
```bash
296296
gh release list --repo layer5io/meshery-cloud --json tagName,isDraft --jq '.[] | select(.isDraft) | .tagName'
@@ -308,9 +308,9 @@ identity and do not fall back silently.
308308

309309
**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.
310310

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).
312312

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.
314314

315315
**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.
316316

0 commit comments

Comments
 (0)