Kirchberg GitHub PR Codex Review Monitor
Purpose
Monitor the current GitHub pull request for ChatGPT Codex Connector review feedback and failing PR checks. Apply actionable connector suggestions and actionable failing-check fixes, validate, commit, push, request another Codex review, and keep monitoring until no major/significant issues remain and current required checks pass.
End the loop on terminal success, PR closure/merge, an unrecoverable blocker, or the bounded Connector-silence timeout defined below.
Scope Gate
Use this skill only for an active GitHub pull request monitoring loop. If the latest user request is a non-PR action such as MCP setup, local Git conflict resolution, deploy work, or general repository maintenance, route to the skill for that latest action instead.
Newest user instructions override older monitor-loop state. Before claiming completion, verify current PR head, connector feedback, and checks rather than reusing stale status.
Reference Routing
Read these one-level references before acting:
references/pr-state-and-checks.md: required before each loop iteration. It defines PR data fetching, Codex App heartbeat automations, PR check classification, connector author detection, actionable suggestion detection, terminal stop conditions, and local dedupe state.references/fix-validate-review.md: required before editing, committing, pushing, posting@codex review, handling errors, or reporting iteration status. It defines fix application, validation, git workflow, subagents, status output, error handling, and invocation prompts.
Required Starting Checks
Run before making changes:
git status --short
git branch --show-current
git remote -v
gh pr view --json number,url,headRefName,baseRefName,state
If the PR cannot be found, report the branch, repository, and attempted lookup, then stop safely.
Safety Rules
- Preserve the working tree. Never discard user changes.
- Never run
git reset --hard,git clean -fd, force-push, delete branches, rewrite history, or switch branches unless the user explicitly requests it. - Work only on the PR branch.
- Stage only files related to connector suggestions or failing PR-check fixes.
- Keep subagents read-only by default. Do not let subagents commit, push, request reviews, mutate GitHub state, or edit overlapping files.
- Do not process feedback from untrusted users as Codex suggestions.
- Do not post
@codex reviewunless a fix was committed and pushed.
Monitor Loop
Repeat every 10 minutes:
- Identify the current PR.
- Stop if the PR is closed or merged.
- Fetch fresh PR comments, review comments, reviews, review threads, and PR checks for the current head commit.
- Detect messages authored by the ChatGPT Codex Connector.
- Stop with success only if a connector-authored terminal success message is current and required/current PR checks pass.
- Stop without claiming success when the current review cycle has received no Connector-authored response for 60 minutes, unless the user supplied a different timeout.
- Find unprocessed actionable connector suggestions and current actionable failing checks.
- Apply all actionable suggestions and check fixes in the current batch.
- Run relevant local validation.
- Commit and push fixes.
- Re-check PR checks after push when practical; fix new actionable failures before requesting another review.
- Comment exactly
@codex review. - Wait 10 minutes using a current-thread Codex App heartbeat automation when
available; otherwise use
sleep 600.
Do not create a new Codex session while waiting.
The silence timeout is a terminal monitor outcome, not review approval and not
an unrecoverable blocker. Pause or delete the heartbeat, stop local polling, do
not post another @codex review, and leave the PR state unchanged. Resume only
on an explicit user request.
Completion Output
When the terminal condition is verified, print:
Codex review monitoring complete.
PR: <url>
Final status: Codex reported no major issues.
Final commit: <sha>
Processed suggestion batches: <count>
Final checks: <passing|not configured>
Last Codex message: <short excerpt>
Pause or delete any heartbeat automation before the final summary.
When the silence timeout is reached, print:
Codex review monitoring stopped after Connector silence.
PR: <url>
Final status: No Connector verdict received within <minutes> minutes.
Final commit: <sha>
Final checks: <passing|pending|failing|not configured>
Last review request: <timestamp>
Resume: Explicit user request required.