用途:该技能用于从 dev 分支创建发布分支,完成版本号升级并生成结构化更新日志 PR。适用场景包括准备新版本发布、递增版本号或执行发布(cut a release)。
主要能力与用法:接受可选的版本参数(例如 /release 17.1.2);若未提供版本,则读取 package.json 当前版本并建议下一个补丁版本,经用户确认后继续。
执行步骤:
- 预检:git fetch origin;git status(必须干净,否则警告并停止);git checkout dev;git pull;用 git log dev..origin/main --oneline 检查 dev 是否落后于 main,若有则警告用户。
- 确定版本。
- 创建分支:git checkout -b release/<version>,命名规范 release/X.Y.Z。
- 更新版本文件:package.json 的 version 字段;server.json 的两个 version 字段(顶层与 packages[0].version);若存在 .claude-plugin/marketplace.json 则更新其三个 version 字段(metadata.version、plugins[0].version、plugins[1].version);运行 npm install --package-lock-only 同步 package-lock.json。
- 构建验证:运行 npm run build,失败需先修复。
- 提交版本变更,提交信息为 Bump version to <version>。
- 生成更新日志:用 git log origin/main..dev --oneline 获取变更,按类别编写结构化日志,标题格式为 Release/<version>。
- 推送分支并以 main 为目标创建 PR,标题 Release/<version>,正文为更新日志;合并到 main 会通过 GitHub Actions 触发 npm 发布。
涉及文件:package.json、server.json、.claude-plugin/marketplace.json(若存在)、package-lock.json。限制:需保证工作区干净,dev 不得落后于 main,构建必须通过;其他细节资料暂未提供。