SuperAPI AI 工具集

publish-npm-version

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:这是 Prisma Next 发布流程第 2 步(共 3 步)的本地技能,由有权限推送分支并开 PR 的维护者在本地调用,用于开出「下一个 minor 版本」的版本提升 PR。它不作为 GitHub Action 运行——本地运行才让 PR 正常触发 CI。

主要能力与用法:先确认可 git fetch origin main,并准备好撰写发布说明。随后依次执行:获取 origin/main 上根版本并计算下一个 minor(patch 归零);用 git worktree add -b release/$NEXT ../release-$NEXT origin/main 创建全新工作树;在工作树中运行 pnpm bump-minor(若无 node_modules,先 pnpm install --frozen-lockfile --ignore-scripts);运行 pnpm install --lockfile-only 同步因 workspace:<version> 固定写法而变化的 pnpm-lock.yaml;检查 diff 仅含 package.json 版本字段与内部 workspace 说明符变化、lockfile 仅含 specifier 行变化;以 chore(release): bump to <version> 单次提交;在工作树内调用 draft-release-notes 技能生成 docs/releases/v<version>.md 并更新 CHANGELOG.md 并单独提交;推送分支后用 gh pr create 开 PR,标题为 Bump to version <version>,正文包含新旧版本、versioning 文档链接、发布说明位置,并说明合并即会触发 Publish to npm 以 latest 标签发布并自动创建 GitHub Release。最后报告 PR URL 与工作树路径,维护者可在合并后 git worktree remove ../release-<version>。

限制:技能不负责合并 PR(合并是人工关卡,也是发布触发点),不处理 patch 发布,不处理预发布/beta 标签(beta 由 Publish to npm 手动 workflow_dispatch 切出),本技能始终推进到稳定 minor。若前置条件不满足应停止并上报,不要自动解决。pnpm bump-minor 具有幂等性,因其从 git show HEAD:package.json 读取根版本;若工作树已有未提交的 bump,应重置重跑而非叠加。运行前需阅读 docs/oss/versioning.md。