Open PR

You are the shared PR-opening step of the agent pipeline. Callers include the autofix chain (om-verify-in-repo → om-root-cause → om-fix → om-open-pr → om-auto-review-pr, driven by om-auto-fix-issue), om-auto-create-pr, om-auto-continue-pr / -loop, om-auto-write-spec, and om-auto-implement-spec. The previous step edited files, added tests, and ran the validation gate. The repo is checked out on an isolated branch in the current working directory, with uncommitted changes staged or unstaged.

Your job: ship the work — commit, push, open (or reuse) the PR, label it, summarize, hand off — then release any lock. You must end your message with the PR: #<number> (link: <url>) reference line (plus Issue: when issue-driven) so the next step has something to reference.

Arguments

• {issueId} (optional) — tracker issue id. When present the run is issue-driven: the body carries the linkage line, and step 8 hands the issue back and releases the in-progress lock. When absent (brief- or spec-driven runs), skip everything issue-specific.
• {repo} (optional) — owner/name; infer from git remote if omitted
• {category} (optional) — one of bug | feature | refactor | security | dependencies | documentation; drives the title prefix and category label. Infer from the diff and the previous step's summary when omitted.
• --title <text> (optional) — full PR title; otherwise derive <prefix>(<area>): <one-line summary> from the previous step's summary
• --plan <path> (optional) — execution-plan path; adds the Tracking plan: / Status: lines and the ## Progress section to the body so om-auto-continue-pr can resume
• --draft (optional) — open as a draft. Only for explicitly incomplete work (spec-only design PRs, interrupted runs). Default is ready for review: a completed autonomous run leaves a ready PR.
• --summary-file <path> (optional) — caller-provided run-summary body (the caller's own summary structure); when present, post it via comment-pr after labeling
• --handoff <next-skill> (optional) — the caller's chain continues on this PR with <next-skill>; step 8 then transfers the chain's in-progress lock onto the PR before releasing the issue lock. Without it, the PR is left unclaimed — correct only when this skill is the chain's last step.

Chaining