Autopilot PR Review Scheduler

autopilot-pr-review-scheduler

User-facing PR REVIEW queue. This skill SELECTS pull requests and THROTTLES fan-out. It does not triage issues, does not implement, and does not open greenfield PRs.

Compose autopilot-pr-review-worker one PR per slot (INVOCATION_MODE=session-review, panel-mode: full for a first advisory). Never compose autopilot-pr-merge-worker. Drive-to-merge is a different skill.

Never borrow slots from autopilot-issue-triage-scheduler, autopilot-issue-delivery-scheduler, or autopilot-pr-triage-scheduler.

Activation card

activation_card: on. Before any queue read or spawn, emit this Enter card with every field filled. Missing field -> stop.

skill: autopilot-pr-review-scheduler
skill_path: <resolved directory of this SKILL.md>
mode: run
subject: microsoft/apm
path: review
intent: select accepted review PRs and fan out review workers
origin: unattended | actor-session
write: off
repo: microsoft/apm
fanout_limit: <positive integer>
invocation: agentic-workflow | actor-session

Rules:

• write is always off. This scheduler never comments, labels, assigns, or requests reviewers.
• write: on -> stop.
• origin fail-closed unknown -> unattended.
• invocation is the harness. Copilot App, local session, Cloud Agent, and Remote Agent are actor-session. agentic-workflow is only gh-aw / GitHub Actions. Do not copy origin into invocation.
• One queue. Do not nest another scheduler path.
• Do not compose autopilot-pr-merge-worker.

After the run, emit this Exit receipt:

skill: autopilot-pr-review-scheduler
subject: microsoft/apm
path: review
write: off
queued: <integer>
spawned: <integer>
approved: n/a

Invocation

Works in local sessions, Copilot App automations, Cloud Agent, Remote Agent, and Agentic Workflows.

Resolve ORIGIN before spawning slots so each reviewing session can apply ownership writes. This scheduler never comments, labels, assigns, or requests reviewers.

• unattended -- slots never assign, never request reviewers.
• actor-session -- autopilot-pr-review-worker requests @me as a supplemental reviewer. Never assign the PR. Skip only on self-review-red-flag (operator is the PR author).

Ownership writes:

• Issue triage: none (no assignment needed)
• Code (accepted implementation): assign the implementing user
• PR review: the reviewing session requests the reviewing user as reviewer, never assignee. Scheduler does not perform that write.

Selection

panel-review is the only request trigger. It matches .github/workflows/pr-review-panel.md. It is not a human decision label. Re-apply it (remove + add) for a fresh review after the panel clears it.

status/accepted on the PR is a sweep source, not a request trigger. A maintainer already accepted that PR. Union it with the panel-review list. Do not treat status/accepted on a linked issue as a sweep source (that would require listing every open PR).

No accepted, no review. After building the union, drop any PR that is not status/accepted on the PR or a same-repo linked issue. Do not spawn it. Do not comment. Do not remove labels. The review-worker, if already invoked, also stops with no comment and may clear panel-review.

Modes:

• Named list or one PR number: explicit request. Honor those numbers even without panel-review.
• queue-open / no names: open PRs that currently have panel-review or status/accepted on the PR.

Never list all open PRs. Never fall back to an unfiltered gh pr list --state open. Empty label queue -> empty table, stop.

Default (authenticated gh):

gh pr list --state open --label panel-review --json number,title,isDraft,labels,updatedAt
gh pr list --state open --label status/accepted --json number,title,isDraft,labels,updatedAt

Deduplicate by number. Skip drafts unless the caller named them. Label sweep: oldest first, cap 10. Named list is not capped.

Do not invent a second trigger label.

CODEOWNERS last-comment gate

Before any spawn, for each candidate PR (named list, panel-review sweep, or status/accepted on the PR). This gate does not bypass status/accepted. Named list and panel-review do not bypass this gate.

1. Snapshot the CODEOWNERS set from current reviewRequests (users and teams). If empty, use CODEOWNERS for the changed paths. If still empty, skip this gate.
2. Paginate issue comments and submitted reviews to exhaustion. Ignore bots.
3. Last CODEOWNER comment = latest of those authored by the CODEOWNERS set.
4. If none: eligible. The worker still reads full context.
5. Read that comment as standing conditions (open an issue, link it, wait, change approach, add labels, or explicitly ask for a panel or further review). Evaluate whether those conditions are already met using later comments AND current labels on the PR and on same-repo linked issues. Do not treat "last word" as a stop when the asked work is done.
6. If the comment explicitly asks for a panel or further review, or its conditions are met: eligible. The comment is required context. Do not contradict it.
7. If conditions are not met: drop. Do not spawn. Do not comment. Do not change labels. Rationale: CODEOWNERS last comment conditions unmet.
8. If it is unclear whether conditions are met: fail closed. Drop with rationale: CODEOWNERS last comment conditions unclear.