$npx -y skills add arch-team/devpace --skill pace-releaseUse when user says "发布", "部署", "上线", "release", "pace-release", or wants to create, deploy, or close a release. NOT for CI/CD pipeline management (use /pace-sync). NOT for code implementation (use /pace-dev).
| 1 | # /pace-release — 发布管理 |
| 2 | |
| 3 | > **可选功能**:如果你没有正式的发布流程,不需要使用这个命令。任务 merged 就是你的完成点,不需要 Release 管理。 |
| 4 | |
| 5 | 管理 Release 生命周期:收集候选变更 → 创建 Release → 追踪部署 → 验证 → 关闭。支持 Changelog、版本 bump、Git Tag、GitHub Release、Release Notes 和发布分支管理。 |
| 6 | |
| 7 | ## 推荐使用流程 |
| 8 | |
| 9 | ``` |
| 10 | 标准发布: create → deploy → verify → close |
| 11 | 快速查看: status(或无参数启动引导向导) |
| 12 | 单步操作: changelog / version / tag / notes(独立使用) |
| 13 | 回滚处理: rollback → 创建 hotfix CR → 新 create |
| 14 | 历史回顾: status history |
| 15 | ``` |
| 16 | |
| 17 | ## 输入 |
| 18 | |
| 19 | $ARGUMENTS: |
| 20 | |
| 21 | **日常使用**(大多数场景只需这些): |
| 22 | - `create` → 创建新 Release(收集 merged CR + Gate 4 检查) |
| 23 | - `deploy` → 记录部署操作(支持多环境晋升) |
| 24 | - `verify` → 执行验证清单(支持自动化验证) |
| 25 | - `close` → 完成发布(自动 changelog + 版本 bump + tag + 连锁更新) |
| 26 | - `full` → close 的推荐别名(语义更明确) |
| 27 | - `status` → 查看当前 Release 状态和建议下一步 |
| 28 | - (空)→ 引导式发布向导(推荐新用户使用) |
| 29 | |
| 30 | **单独使用**(当你只需要其中某个步骤时): |
| 31 | - `changelog` → 仅生成 CHANGELOG.md |
| 32 | - `version` → 仅更新版本文件 |
| 33 | - `tag` → 仅创建 Git Tag / GitHub Release |
| 34 | - `notes` → 生成面向用户的 Release Notes(按 Epic→BR→PF 组织,支持 `--role biz|ops|pm`) |
| 35 | - `branch` → 管理发布分支(创建 / PR / 合并) |
| 36 | - `rollback` → 记录回滚(deployed 状态下出现严重问题时) |
| 37 | - `status history` → 发布历史时间线(跨 Release 纵向视图 + DORA 趋势) |
| 38 | |
| 39 | ## 执行路由 |
| 40 | |
| 41 | 根据子命令,**只读取路由表中对应的 procedures 文件,不加载其他 procedures 文件。** |
| 42 | |
| 43 | ### 核心操作固定加载 |
| 44 | |
| 45 | core 子命令(create/deploy/verify/close/full)加载 `skills/pace-release/release-procedures-common.md`(发布规则 + 集成规则 + 版本推断 SSOT)。 |
| 46 | |
| 47 | ### 按子命令加载 |
| 48 | |
| 49 | | 参数 | 加载文件 | 说明 | |
| 50 | |------|---------|------| |
| 51 | | (空) | `skills/pace-release/release-procedures-wizard.md` | 自包含;引导式向导(含 rolled_back 追踪) | |
| 52 | | `create` | `skills/pace-release/release-procedures-common.md` + `skills/pace-release/release-procedures-create.md`;CR>3 或有 config.md 时追加 `skills/pace-release/release-procedures-create-enhanced.md` | 分层加载 | |
| 53 | | `deploy` | `skills/pace-release/release-procedures-common.md` + `skills/pace-release/release-procedures-deploy.md` | 环境晋升 + 路径全景 | |
| 54 | | `verify` | `skills/pace-release/release-procedures-common.md` + `skills/pace-release/release-procedures-verify.md` | 自动健康检查 + 问题处理 | |
| 55 | | `close` / `full` | `skills/pace-release/release-procedures-common.md` + `skills/pace-release/release-procedures-close.md`;步骤 1-3 按执行进度加载 `skills/pace-release/release-procedures-changelog.md` / `skills/pace-release/release-procedures-version.md` / `skills/pace-release/release-procedures-tag.md` | 步进式增量加载 | |
| 56 | | `changelog` | `skills/pace-release/release-procedures-changelog.md` | 自包含 | |
| 57 | | `version` | `skills/pace-release/release-procedures-version.md` | 自包含(含精简版本推断规则) | |
| 58 | | `tag` | `skills/pace-release/release-procedures-tag.md` | 自包含 | |
| 59 | | `rollback` | `skills/pace-release/release-procedures-rollback.md` | 自包含(含候选预填) | |
| 60 | | `notes` | `skills/pace-release/release-procedures-notes.md` | 自包含(支持 `--role biz\|ops\|pm`) | |
| 61 | | `branch` | `skills/pace-release/release-procedures-branch.md` | 自包含 | |
| 62 | | `status` / `status history` | `skills/pace-release/release-procedures-status.md` | 自包含 | |
| 63 | |
| 64 | > **`skills/pace-release/release-procedures-scheduling.md`** 不对应用户子命令,由 wizard(发布窗口提醒)或 pace-pulse 按需加载。 |
| 65 | |
| 66 | ## 输出 |
| 67 | |
| 68 | Release 操作结果摘要(3-5 行)。 |