SuperAPI AI 工具集

release-rstack

编程与开发

查看项目

更新于 10-18 04:20

技能介绍

用途

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 或存在歧义的变更时,停止并询问用户。

步骤

  1. 用 git status --short 检查工作区。若存在未提交改动或未跟踪文件,停止并询问用户如何处理;不要 stash、丢弃或将其纳入提交。
  2. 确认当前分支是仓库默认分支。将发布分支设为 release/v<版本>,检查本地与远程是否已存在同名分支;若已存在,停止并询问用户。
  3. 从干净的默认分支 HEAD 创建并切换到 release/v<版本>。
  4. 将 packages/rstack/package.json 的 version 字段更新为 <版本>,将 packages/create-rstack/package.json 的 version 字段更新为按规则推导出的 create-rstack 版本。
  5. 在每个 packages/create-rstack/template-*/package.json 中,把 rstack 依赖设为 ^<版本>;只更新该依赖项,并核对所有模板均使用同一目标版本。
  6. 运行 pnpm --filter rstack build:native,为新版本重新生成 packages/rstack/binding.cjs 与 packages/rstack/binding.d.cts;不要手动编辑生成的绑定文件。
  7. 审查 diff,确认其中仅包含两个包的版本变更、模板中的 rstack 依赖更新以及上述重新生成的绑定文件;核对两个包的版本变更使用预期的匹配升级类型,且没有模板残留旧版 rstack 版本。
  8. 使用确切提交信息 release: v<版本> 创建提交。
  9. 将分支推送到 origin;推送前再次确认所推分支为 release/v<版本>,绝不直接推送默认分支。
  10. 向默认分支创建拉取请求。在 Codex 中使用 GitHub 连接器/插件;仅当连接器不可用时才使用其他可用的 GitHub 流程。PR 标题使用 release: v<版本>。
  11. 返回拉取请求 URL。

适用场景

适用于需要为 rstack 与 create-rstack 两个 npm 包进行一次版本协同发布,并希望以标准化分支、提交与拉取请求流程完成发布的维护者场景。

限制

该技能是针对 rstackjs/rstack-cli 仓库的具体发布流程,包含固定的目录与文件路径、构建命令以及提交与分支命名约定;使用前需具备干净的默认分支工作区,并依赖 pnpm 与可用的 GitHub 工作流。遇到 major 版本、分支冲突或工作区不干净等情况时,技能会停止并要求用户决策。