| name | pr-to-git |
| description | Open a GitHub Pull Request for review by a responsible agent (e.g., CODEX), wait for its response (text comment or ๐ reaction), remind it after 6 minutes with an @mention, and merge on approval โ or after a 4-minute grace if no response. Use when the user asks to "send via PR for review", "open a PR and wait for <agent>", or to ship a reviewed change through the responsible-agent gate. |
/pr-to-git โ Push a PR, await responsible-agent review, merge
Language: communicate with the user in Hebrew; all git/PR content in English.
Purpose. Automate the "send the final work to GitHub as a Pull Request, let the responsible review agent (currently CODEX) respond, then merge" loop, with the exact timing rules below. The skill only PUSHES the PR and drives the wait/remind/merge logic โ it does not implement the change itself.
Parameters (resolve before running)
| Param | Default | Notes |
|---|
REVIEWER | codex | OpenAI's Codex coding agent โ GitHub user @codex. TRIGGER it by tagging @codex in the PR body (and in the reminder comment) โ NOT via --reviewer (it's a bot, not an assignable collaborator-reviewer). Requires the user's ChatGPT account connected to GitHub (done). It responds to @mentions on PRs with reviews/comments. |
REVIEWER_IS_COLLABORATOR | unknown | If true, add as a PR reviewer (--reviewer). If false, rely on @mention + the agent watching the repo. |
FALLBACK_REVIEWER | Opus 4.8 (thinking) | The responsible agent to use if the primary (CODEX) is at its usage limit / cannot review. See "Fallback responsible agent" below. |
BASE | main | Base branch to merge into. |
HEAD | pr/<slug>-<date> | Feature branch holding the change. Create if not already on one. |
PR_TITLE / PR_BODY | โ | Title + body. Body should summarize the change and explicitly request the reviewer's approval (text or ๐). |
INITIAL_WAIT | 360 sec (6 min) | Continuous wait before the reminder. |
GRACE_WAIT | 240 sec (4 min) | Wait after the reminder before merging anyway. |
POLL_INTERVAL | ~75 sec | How often to poll (stay under the 5-min cache window when actively polling). |
MERGE_METHOD | --squash | Merge strategy (--squash / --merge / --rebase). |
Resolve OWNER/REPO from gh repo view --json nameWithOwner.
Workflow
Step 1 โ Stage the change on a feature branch
- Ensure the working tree holds the intended change (the caller has already produced it).
- If currently on
BASE, create and switch to HEAD: git checkout -b <HEAD>.
- Commit (English message + the Co-Authored-By trailer the repo convention requires) and push:
git push -u origin <HEAD>.
- If the account enforces email privacy, use the GitHub noreply email (see the repo's gotcha) so the push isn't rejected.
Step 2 โ Open the PR
gh pr create --base <BASE> --head <HEAD> --title "<PR_TITLE>" --body "<PR_BODY>"
# add --reviewer <REVIEWER> ONLY if REVIEWER_IS_COLLABORATOR is true
Capture the PR number and URL (gh pr view --json number,url). Tell the user the PR URL and that the wait has started.
Step 3 โ Poll for the responsible agent's response (up to INITIAL_WAIT)
A response from the responsible agent is ANY of:
- An approving review: a review with state
APPROVED.
- A ๐ reaction (
+1 / THUMBS_UP) on the PR itself or on the PR body/a comment, authored by REVIEWER (or, if REVIEWER handle is unknown, by anyone who is not the PR author).
- A text comment authored by
REVIEWER (or any non-author if the handle is unknown).
Poll every POLL_INTERVAL seconds, accumulating elapsed time up to INITIAL_WAIT:
# reviews + comments
gh pr view <n> --json reviews,comments,state,mergeStateStatus
# PR-level reactions (a PR is an issue):
gh api repos/<OWNER>/<REPO>/issues/<n>/reactions --jq '.[] | {by: .user.login, content}'
# reaction on a specific comment:
gh api repos/<OWNER>/<REPO>/issues/comments/<comment_id>/reactions --jq '.[] | {by: .user.login, content}'
Classify the first qualifying response:
- Approval =
APPROVED review, OR a ๐ reaction, OR a text comment that is affirmative ("LGTM", "approved", "ok to merge", "๐", "ship it", Hebrew "ืืืฉืจ"/"ืืคืฉืจ ืืืื"). โ go to Step 5 (MERGE).
- Change request = a
CHANGES_REQUESTED review, OR text that clearly asks for changes/raises blocking concerns. โ go to Step 6 (STOP & surface).
- No qualifying response yet โ keep polling.
Do NOT poll with blocking sleep in the foreground. Use the harness wait primitive (Monitor / a run_in_background poll loop, or ScheduleWakeup with a sub-INITIAL_WAIT delay) so the session stays responsive. Track elapsed time explicitly.
Step 4 โ Reminder after 6 minutes of silence
If INITIAL_WAIT elapses with no qualifying response, post ONE reminder comment that @mentions the responsible agent:
gh pr comment <n> --body "@<REVIEWER> friendly reminder โ this PR is awaiting your review (text or a ๐). Will merge after a short grace window if there's no response. Thanks!"
Then continue polling for up to GRACE_WAIT more seconds.
Step 5 โ Merge on approval (or after the grace window)
Merge when EITHER an approval arrived (any step) OR GRACE_WAIT elapsed after the reminder with still no response:
gh pr merge <n> <MERGE_METHOD> --delete-branch
- Confirm merge succeeded (
gh pr view <n> --json state โ MERGED).
- If merge is blocked (required checks failing, conflicts, branch protection), DO NOT force โ STOP and surface the blocker to the user.
- Report to the user: what happened (approved-and-merged, ๐-and-merged, or timed-out-and-merged-per-policy) + the final state + the merge commit.
Step 6 โ On a change-request response
If the responsible agent's response requests changes (not an approval): STOP, do NOT merge, and surface the exact feedback to the user (and the caller) so the change can be revised and the PR updated. Re-running the wait loop resumes after the revision is pushed.
Fallback responsible agent (Codex usage-limit โ Opus 4.8 thinking)
The primary responsible agent is CODEX. If CODEX has reached its usage limit or otherwise cannot perform the review, the responsible-agent role escalates to FALLBACK_REVIEWER = Opus 4.8 (thinking).
Trigger โ switch to the fallback when ANY holds:
- CODEX posts a comment indicating it cannot review (text matching
usage limit / rate limit / quota / over limit / cannot review / unavailable, in English or Hebrew equivalents).
- The CODEX integration errors out / is unreachable when the PR is opened.
- (Optional, operator-set) the user states CODEX is at its limit for this run.
Note: a plain SILENCE timeout is NOT the fallback trigger โ silence follows the ยง2 reminderโgraceโmerge path. The fallback is specifically for CODEX being UNABLE to review.
Fallback action: run an Opus 4.8 reviewer with extended thinking (the Agent tool with model: opus + high/xhigh effort) as the responsible agent: it reads the PR diff + the changed plan/docs, then posts its verdict AS A PR COMMENT (so the record lives on the PR), formatted as either an approval ("โ
Approved โ โฆ") or a change-request ("๐ง Changes requested โ โฆ"). Then apply the SAME response/merge logic: an approving Opus verdict (or ๐) โ merge; a change-request โ STOP & surface (Step 6). Because the fallback reviewer is one we drive, it should respond promptly (no 6+4-minute wait needed once it has run).
Record which agent reviewed (CODEX or the Opus fallback) in the merge report to the user.
Timing rules (verbatim from the user's spec โ section 2)
- Wait for the responsible agent's response after opening the PR.
- "Response" = (1) a text comment, or (2) a ๐ (Thumbs-Up) reaction.
- On approval of the PR by the responsible agent โ MERGE is permitted.
- If NO response for 6 full continuous minutes โ remind the responsible agent with an
@-mention comment, then wait up to 4 more minutes.
- If still no response by the end of the grace window โ MERGE anyway.
Guardrails
- Never force-merge over failing required checks or branch protection โ surface instead.
- Never merge a PR whose only response is an explicit change-request.
- Only post ONE reminder (no spamming).
- Private repos: the responsible agent must be a collaborator to comment/react; if it cannot respond at all, the timeoutโmerge path applies (warn the user that no human/agent review was recorded).
- Respect the repo's commit-email privacy (noreply) and Co-Authored-By trailer conventions.
- Idempotent: if a PR for
HEADโBASE already exists, reuse it instead of creating a duplicate.
