用途
Release Rstack 是 rstackjs/rstack-cli 提供的发布流程技能,用于为 rstack 和 create-rstack 两个 npm 包准备一次协同发布:生成发布分支、更新版本与模板依赖、重新生成绑定文件,并创建发布用拉取请求。
输入
调用时需给出目标版本号,格式为不带前导 v 的版本,例如 1.2.0。如果未提供版本号,应先询问用户,再进行任何修改。
版本规则
- 编辑前先读取两个包的当前版本。
rstack的目标版本必须是有效且递增的 SemVer 版本。- 两个包的版本行相互独立,但需将
rstack的升级类型应用到当前create-rstack版本上:- Patch:递增 patch 版本。
- Minor:递增 minor 版本并将 patch 归零。
- Prerelease:使用
rstack目标版本的标识符;从稳定版本升级时递增 patch 并追加-<标识符>.0,否则递增末尾的预发布编号。 - 相同核心版本的预发布转稳定:移除
create-rstack的预发布后缀。
- 遇到 major 或存在歧义的变更时,停止并询问用户。
步骤
- 用
git status --short检查工作区。若存在未提交改动或未跟踪文件,停止并询问用户如何处理;不要 stash、丢弃或将其纳入提交。 - 确认当前分支是仓库默认分支。将发布分支设为
release/v<版本>,检查本地与远程是否已存在同名分支;若已存在,停止并询问用户。 - 从干净的默认分支 HEAD 创建并切换到
release/v<版本>。 - 将
packages/rstack/package.json的 version 字段更新为<版本>,将packages/create-rstack/package.json的 version 字段更新为按规则推导出的create-rstack版本。 - 在每个
packages/create-rstack/template-*/package.json中,把 rstack 依赖设为^<版本>;只更新该依赖项,并核对所有模板均使用同一目标版本。 - 运行
pnpm --filter rstack build:native,为新版本重新生成packages/rstack/binding.cjs与packages/rstack/binding.d.cts;不要手动编辑生成的绑定文件。 - 审查 diff,确认其中仅包含两个包的版本变更、模板中的 rstack 依赖更新以及上述重新生成的绑定文件;核对两个包的版本变更使用预期的匹配升级类型,且没有模板残留旧版 rstack 版本。
- 使用确切提交信息
release: v<版本>创建提交。 - 将分支推送到 origin;推送前再次确认所推分支为
release/v<版本>,绝不直接推送默认分支。 - 向默认分支创建拉取请求。在 Codex 中使用 GitHub 连接器/插件;仅当连接器不可用时才使用其他可用的 GitHub 流程。PR 标题使用
release: v<版本>。 - 返回拉取请求 URL。
适用场景
适用于需要为 rstack 与 create-rstack 两个 npm 包进行一次版本协同发布,并希望以标准化分支、提交与拉取请求流程完成发布的维护者场景。
限制
该技能是针对 rstackjs/rstack-cli 仓库的具体发布流程,包含固定的目录与文件路径、构建命令以及提交与分支命名约定;使用前需具备干净的默认分支工作区,并依赖 pnpm 与可用的 GitHub 工作流。遇到 major 版本、分支冲突或工作区不干净等情况时,技能会停止并要求用户决策。