SuperAPI AI 工具集

Release

通用与其它

查看项目

更新于 10-16 08:45

技能介绍

用途:为 linear-cli 项目创建并发布新版本,覆盖变更日志管理、版本号提升、测试与打标签的完整流程,确保变更被记录、测试通过、版本正确标记后再发布。

前置工具:changelog 技能、svbump、jj、just、jq。

主要流程:一、用 jj log --ignore-working-copy --git -r 'tags()..@' --no-graph 查看上次发布以来的提交。二、为各提交添加变更日志条目,聚焦面向用户的变化(新功能、修复、破坏性变更、重要改进、弃用),排除纯内部重构、仅文档、构建/CI 及琐碎变更;用 changelog add --type <type> "<description>" --attribute-pr <commit-sha> --exclude-users schpet,schpetbot 添加,类型对应 Keep a Changelog 的 added、changed、deprecated、removed、fixed、security。三、展示 CHANGELOG.md 的 [Unreleased] 段落请用户审阅并调整。四、依据变更类型推荐语义化版本:主版本为破坏性变更、移除功能、重大 API 变动;次版本为新功能、弃用;补丁为修复、安全修复、无新功能的小改进;展示当前与建议版本并等待确认。五、确认后运行 changelog release <major|minor|patch>。六、运行 just tag,首错即停,依次执行质量检查(cargo fmt --all --check、cargo clippy --locked --workspace --all-targets -- -D warnings、cargo test --locked --workspace)、用 svbump 将最新版本写入 Cargo.toml 的 workspace.package.version 并 cargo update --workspace、just skill-docs 重新生成技能文档、just plugin-version 设置插件版本、jj commit 与打 v<version> 标签、分别用 jj git push --bookmark main 和 git push origin --tags 推送;完成后打印 released v<version>。

错误处理:质量检查失败须先修复,测试或检查不通过不得继续;版本提升失败检查格式与文件;推送失败检查认证与远程;任何关键步骤失败应停止并清晰报告。

注意:tag recipe 已包含全部步骤,无需手工逐步执行;版本控制统一用 jj,只读操作加 --ignore-working-copy;提交建立在 @- 上;jj 推送书签与 git 推送标签均需执行。发布后核实标签、GitHub Actions 发布流程及版本是否发布。justfile 中 tag 与 plugin-version 提供具体实现参考。