菜单
Create/update PRs with Conventional Commits title, issue linking & guard rails. Triggers: "create PR" | "open PR" | "submit PR" | "update PR" | "/pr --draft" | "open a pull request" | "make a PR" | "open pull request" | "submit a pull request" | "create a draft PR" | "raise a PR".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Set up local dev environment — stack.yml, CLAUDE.md Critical Rules, docs scaffolding, LSP. Triggered by /dev-init or standalone /env-setup. Triggers: "env setup" | "setup environment" | "configure stack" | "scaffold rules".
Populate scaffolded architecture/standards docs with real content extracted from CLAUDE.md and codebase analysis — fills TODO stubs, writes AI Quick Reference sections. Triggers: "seed docs" | "bootstrap docs" | "populate docs" | "fill architecture docs" | "seed architecture".
Initialize project — orchestrates env-setup, ci-setup, release-setup + axial ADR. Use when setting up a new repo or re-running Roxabi project init. Triggers: "dev-init" | "setup project" | "initialize project" | "/dev-init". Not the harness built-in /init (CLAUDE.md scaffold only).
Promote staging→main — pre-flight, version bump, changelog, PR & tag. Triggers: "promote staging" | "release" | "deploy" | "cut a release" | "--finalize" | "merge to main" | "promote to production" | "ship a release" | "tag and release" | "publish release".
Set up CI/CD — GitHub Actions workflows, TruffleHog, Dependabot, pre-commit hooks, marketplace plugins. Triggers: "ci setup" | "setup ci" | "configure ci" | "setup hooks" | "setup github actions".
Health check — verify dev-core config, GitHub project, labels, workflows, branch protection, secret scanning, CI hardening. Triggers: "checkup" | "health check" | "check setup" | "verify config" | "security baseline".
| name | pr |
| description | Create/update PRs with Conventional Commits title, issue linking & guard rails. Triggers: "create PR" | "open PR" | "submit PR" | "update PR" | "/pr --draft" | "open a pull request" | "make a PR" | "open pull request" | "submit a pull request" | "create a draft PR" | "raise a PR". |
I := PR created ∧ pushed ∧ rebased on base
V := gh pr view {N} ∧ git log origin/${BASE}..HEAD non-empty
Let:
β := staging (∃ origin/staging) ∨ main
Β := current branch
N := issue# (first number after / in Β)
Β → PR: Conventional Commits title, issue linking, guard rails.
Flow: single continuous pipeline. ¬stop between steps. Stop only on: REFUSE, explicit Cancel, or Step 6 completion.
| Step | ID | Required | Verifies via | Notes |
|---|---|---|---|---|
| 1 | gather-state | ✓ | state JSON emitted | — |
| 2 | guard-rails | ✓ | ¬REFUSE | — |
| 3 | generate | ✓ | title + body ready | — |
| 4 | create | ✓ | gh pr create success | — |
| 5 | rebase | ✓ | git push success | — |
| 6 | watch | — | — | inform only |
Success: PR created ∧ pushed ∧ rebased on base
Evidence: gh pr view {N} returns valid PR
Steps: gather-state → guard-rails → generate → create → rebase
¬clear → STOP + ask: "Which branch are you PR-ing from?"
bash ${CLAUDE_SKILL_DIR}/gather-state.sh
Emits: branch, base, commit log, diff stat, existing PR, issue number, lifecycle artifacts (analysis, spec), test file count.
| Check | Condition | Action |
|---|---|---|
| Protected branch | Β ∈ {staging, main, master} | REFUSE. Create feature branch first. Stop. |
| No commits | git log origin/${β}..HEAD empty | REFUSE. Nothing to PR. Stop. |
| PR exists | gh pr list → result | → present choice Update (gh pr edit) | Cancel |
| Branch not pushed | git ls-remote --heads origin $BRANCH empty | git push -u origin $BRANCH |
| Quality gates | {commands.lint} && {commands.typecheck} | Warn on failure, ¬block. Note in PR body if proceeding. |
(Note: "behind base" is no longer a guard rail — Step 5 rebases post-create automatically.)
3a. Commits + diff:
git log origin/${BASE}..HEAD --format="%h %s%n%b"
git diff origin/${BASE}...HEAD --stat
3b. Lifecycle artifacts: already emitted by Step 1 (issue, analysis, spec, issue_data, test_files).
N detection: first number after / in Β (e.g. feat/42-slug → #42). ¬found → ask user "Which issue number does this PR close, if any?"
3c. Title: <type>(<scope>): <desc> (≤70 chars). Type from primary commit purpose. Scope from files: web | api | ui | config ∨ omit if cross-cutting.
3d. Body: template below.
Show generated title + body → create immediately (¬ask how). --draft → draft.
Failure ∨ explicit edit request → present choice Edit title/body | Cancel
gh pr create --title "<title>" --body "<body>" --base ${BASE} [--draft]
# --base <branch> if flag specified (overrides BASE)
Display PR URL.
Updating existing PR → gh pr edit <number> --title "<title>" --body "<body>".
After PR creation, rebase Β on latest β → force-push with lease → PR updates with current base.
git fetch origin ${BASE}
BEHIND=$(git rev-list HEAD..origin/${BASE} --count)
BEHIND == 0 → skip rebase, skip push. Log: "Already up to date with origin/${BASE}."
BEHIND > 0:
git rebase origin/${BASE}
# On conflict: → present choice **Resolve manually then re-run /pr** | **Abort rebase** (`git rebase --abort`)
git push --force-with-lease origin ${BRANCH}
Safety: only --force-with-lease (not --force) — refuses push if remote moved unexpectedly. Only on the feature branch (Β ∉ {staging, main, master} is already enforced in Step 2).
Why post-create: ensures the PR reflects the latest base from the moment it lands, so reviewers see a minimal diff and CI runs against current base. Staging can move between branch creation and PR create — this step closes that gap.
Inform: "CI is running on the PR — use /ci-watch to monitor it live."
Merge path = gate-driven: reviewed label + auto-merge (gh pr merge --auto --merge). ¬manual gh pr merge while any check is IN_PROGRESS/QUEUED — the gate decides, not the operator.
## Summary
- {what changed and why}
- {secondary change if applicable}
## Lifecycle
| Phase | Artifact | Status |
|-------|----------|--------|
| Intent | #{N}: {title} | {state} |
| Analysis | [{filename}](artifacts/analyses/{filename}) | Present/Absent |
| Spec | [{filename}](artifacts/specs/{filename}) | Present/Absent |
| Implementation | {N} commits on `{branch}` | Complete |
| Verification | Lint {✅/❌} Typecheck {✅/❌} Tests {✅/❌} ({N} new) | Passed/Failed |
## Test Plan
- [ ] {how to verify}
- [ ] {edge case}
## SC → Test Matrix
(Insert the fenced SC→Test Matrix block emitted by `/implement` Step 6a — a chained run carries it in conversation context; for a standalone `/pr`, retrieve it from the implement summary or reconstruct from the spec SCs + landed tests. Tier S: omit this section entirely — see the Lifecycle note below.)
| SC | Test(s) | Status |
|----|---------|--------|
| SC1: {text} | `{file} :: {test name}` | ⏳ not run |
Fixes #{N}
---
Generated with [Claude Code](https://claude.com/claude-code) via `/pr`
Lifecycle notes: S-tier → Intent + Implementation + Verification only. ¬issue → omit Lifecycle + Closes. S-tier → also omit SC → Test Matrix section.
| Flag | Description |
|---|---|
| (none) | Target auto-detected base branch |
--draft | Create as draft |
--base <branch> | Override base branch |
| Scenario | Behavior |
|---|---|
| Β ∈ {staging, main, master} | REFUSE: "Create a feature branch first" |
| ¬commits ahead | REFUSE: "Nothing to create a PR for" |
| PR already exists | Offer gh pr edit to update |
| ¬N in branch | → ask user link issue or skip |
| Multiple commit types | Use primary type only |
| Lint/typecheck fail | Warn + present choice: Proceed anyway | Fix first |
staging, main, mastergit push --force — only --force-with-lease, and only during Step 5 rebase on feature branchesgh pr merge while any check is IN_PROGRESS/QUEUED — manual merge mid-CI cancels in-flight runs (concurrency.cancel-in-progress) and skips gates. Nominal path: reviewed label → auto-merge (--merge) on green./implement (worktree with commits)/ci-watch/dev owns the dev-pipeline task lifecycle externally/dev: PR created + rebased + pushed → return control silently. ¬write summary. ¬ask user. ¬announce /ci-watch. /dev re-scans and advances.Next: /ci-watch --pr {PR#}. Stop./dev presents Retry | Skip | Abort.$ARGUMENTS