메뉴
Sprint 出口（/release）：分支 merge/PR/保留/丢弃 4 选 1 · semver · CHANGELOG · tag。 说「收尾」「merge」「开 PR」「发版」「打 tag」「分支怎么办」时用。自治发版→ship agent。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
总入口（/master）— 迷路时 AskQuestion 路由 plan/run/learn 等
交付验收（/delivery）：视觉 · i18n · 文档对齐 · 后端对接 · 组件完整度 · 可维护性 · 生产就绪。Sprint 收尾或 /release 分支前走查。说「交付验收」「上线前检查」「生产就绪」时用。
规划（/plan）：需求→先总后分→Sprint→plan.md→/run。说「规划」「拆任务」时用。禁止写业务代码。≠ IDE Plan 模式。
执行（/run）：gate-check→ACTIVE→验收→审计→CHANGELOG→README（门面）→plan→必 commit。每任务/Sprint 收尾自动提交。
脚手架（/scaffold）：空项目创建栈模板，已有项目审计与建议。说「初始化」「创建项目」「脚手架」时用。须用户确认后再创建。
可发布测试报告（/report）— 全量/分层 verify 后汇总 · Report Contract · 日志解析 · benchmark 文档。项目无关 · 操作者无关。说「测试报告」「全量测试报告」「verify 报告」「benchmark 报告」时用。
| name | release |
| description | Sprint 出口（/release）：分支 merge/PR/保留/丢弃 4 选 1 · semver · CHANGELOG · tag。 说「收尾」「merge」「开 PR」「发版」「打 tag」「分支怎么办」时用。自治发版→ship agent。 |
| disable-model-invocation | true |
用这个：/release 人主导（分支 4 选 1 + 可选打版清单）。不是那个：自治执行打版步骤 → 委派 ship（同一 §打版 SSOT，无第二套流程）。
Sprint/Task 代码已绿、run 归档后：先汇入主轨，再打版。不替代日常 git commit 纪律。
./.cursor/bin/runner.sh task-verify # 或 verify（Sprint 收尾）
git status && git diff --stat
config/release.json · config/workflow.json · tag 规则见 rules/feedback/tag.mdc
/delivery；有 Blocker 须在 AskQuestion 前报告Verify → （建议）delivery → AskQuestion（4 选 1；不可用 → 正文编号，见 master「AskQuestion 约定」） → 执行 → 可选 worktree 清理（见 git skill）
| # | 选项 | 动作 |
|---|---|---|
| 1 | 本地 merge | checkout 基线分支 · merge feature · 跑 verify · 删本地 feature（用户确认后） |
| 2 | Push + PR | git push -u origin HEAD · gh pr create（Summary + Test plan · 含 TASK ID） |
| 3 | 保留分支 | 仅 push 或保持现状；不 merge、不删 worktree |
| 4 | 丢弃 | 须用户明确打字确认；禁止静默 force/reset |
Detached HEAD / 无名分支：仅呈现选项 2–4。
PR 生命周期（评论、CI、拆 PR）：babysit · split-to-prs（master → more → git）。
| 时机 | run | release §分支 |
|---|---|---|
| 单 TASK ✅ · 更新 plan | ✅ | |
| Sprint 全 ✅ · archive | ✅ | 可选接着 §分支 |
| merge / PR / 丢弃 | ✅ |
push --force（除非用户明确）reset --hard · clean -fdx 无确认主轨已绿、需对外版本时执行本节。分支收尾与打 tag 可同一次 /release 会话，但须先完成 verify。
workflow.release.mode）| mode | 适用 | /run 收尾 |
|---|---|---|
patch-per-task（母版默认） | 开源母版 · Sprint 批量交付 | commit；Sprint 末 ship 打 tag |
tag-per-commit | 高频交付业务仓库 | commit + release-tag 每任务 |
| 级别 | 何时用 | 自动？ |
|---|---|---|
| patch | 单 TASK、文档/修复、tag-per-commit 默认 | tag-per-commit：是 |
| minor | 用户可见新能力、无 breaking | 否 — 须 RELEASE_ALLOW_MINOR=true |
| major | Breaking change | 几乎从不自动 |
/learn 审计 changelog-insights §重复模式learn/release-rhythm.md）/delivery §8（长任务闭环）无 Blockerworkflow.followup_gate — 见 config/workflow.json（软闸门，plan §Follow-up 引用）./.cursor/bin/runner.sh release-check — 确认 latest_tag · next_version（见下节）/delivery 无 Blocker/report full regen（test-report · verify 绿后）[Unreleased] · manifest bump · docs纯 Web / 无原生安装包时跳过。有安装包或二进制分发时：
release-tag / next_version 在最新 git tag 上 bump，解析顺序：
| 优先级 | 来源 | tag 匹配 |
|---|---|---|
| 1 | 环境变量 VERSION_TAG_GLOB（workflow.json → version_tag_glob_env） | 自定义 glob |
| 2 | plan <!-- VERSION_LINE: major.minor --> | v{line}.*（例 4.22 → v4.22.*） |
| 3 | （缺省） | v* — 仓库最新 semver tag |
无匹配 tag 时起始版本：plan VERSION_DEFAULT · 环境变量 RELEASE_VERSION_DEFAULT · 0.1.0（有 VERSION_LINE 时为 {line}.0）。
./.cursor/bin/runner.sh release-check
# ready · latest_tag=v4.22.1 · tag_glob=v* · next_version=4.22.2 · tag=v4.22.2
打版前：核对 latest_tag 与 CHANGELOG 上一版一致；next_version 异常时不要打 tag。
./.cursor/bin/runner.sh release-check
./.cursor/bin/runner.sh release-tag # tag-per-commit 默认 patch
RELEASE_BUMP=minor RELEASE_ALLOW_MINOR=true ./.cursor/bin/runner.sh release-tag
自治打版（Agent 按序执行清单）→ ship agent（执行本节；入口指针见 agents/ship.md）· 清单以本节 + rules/feedback/release.mdc 为准。