用途:为 Plannotator 项目准备并执行一次正式发布,覆盖从发布说明撰写到打标签触发发布流水线的完整流程。流程分为四个阶段。
阶段一:起草发布说明。先用 git tag --sort=-v:refname | head -1 找到最新标签,确定新版本号,再用 git log 与 gh pr view 收集变更。重点是为所有参与者署名,包括 PR 作者、issue 提交者、评论者、讨论发起者与功能请求者,可通过 gh issue view 与 gh api 查询。按 references/ 中的模板撰写,输出到仓库根目录 RELEASE_NOTES_v<VERSION>.md,该文件保持未跟踪,不提交,需先交用户审阅。
阶段二:版本升级。仅修改 7 个文件中的版本字段:根 package.json、apps/opencode-plugin/package.json、apps/pi-extension/package.json、apps/hook/.claude-plugin/plugin.json、apps/copilot/plugin.json、根 openpackage.yml、packages/server/package.json。VS Code 扩展独立版本,不修改。
阶段三:构建。按依赖顺序执行 bun run build:review、bun run build:hook、bun run build:opencode、bun run build:pi。随后执行 Pi 一致性检查:核对本地导入与 files 数组、vendor.sh 是否覆盖 shared/ai 导入、运行 bun pm pack --dry-run 并做冒烟测试。
阶段四:提交、打标签与发布。提交版本升级,创建并推送 vX.Y.Z 标签,触发 release.yml 流水线,完成测试、六平台交叉编译、SBOM 生成与校验、SLSA 证明、GitHub Release 创建及 npm 发布。仓库启用了不可变发布,标签推送后无法删除重建,只能发布新版本。发布说明可在发布后用 gh release edit 替换。
限制:资料未提供该技能的具体安装方式、收费信息与适用平台细节。