SuperAPI AI 工具集

release-workflow

部署与运维

查看项目

更新于 10-15 20:05

技能介绍

用途:为 lunar-claude 项目定义发布约定,规范版本递增、变更日志生成与发布打标签流程。交互式发布流程建议使用 git-workflow 插件的 /generate-changelog 命令。

版本方案:采用语义化版本 MAJOR.MINOR.PATCH,标签格式为 v0.x.y(带 v 前缀)。marketplace 与各插件清单的版本独立跟踪。递增规则:含 BREAKING CHANGE 或类型后加 ! 为 Major;feat 为 Minor;仅 fix、docs、refactor、perf、test、chore 为 Patch。

git-cliff 分组:cliff.toml 将约定式提交映射到变更日志分组,如 feat→🚀 Features、fix→🐛 Bug Fixes、refactor→🚜 Refactor、doc→📚 Documentation、perf→⚡ Performance、style→🎨 Styling、test→🧪 Testing、chore/ci→⚙️ Miscellaneous Tasks、正文含 security→🛡️ Security、revert→◀️ Revert。自动跳过 chore(release): prepare for、chore(deps*)、chore(pr)/chore(pull) 等提交。

发布需更新文件:CHANGELOG.md(由 git-cliff --tag vX.Y.Z -o CHANGELOG.md 生成)、.claude-plugin/marketplace.json 的 metadata.version,以及有改动的插件清单 plugins/<cat>/<name>/.claude-plugin/plugin.json。

发布提交与打标签命令: $ git add CHANGELOG.md .claude-plugin/marketplace.json $ git commit -m "docs: update changelog for vX.Y.Z" $ git tag -a vX.Y.Z -m "Release vX.Y.Z" $ git push && git push --tags

GitHub Actions(release.yml)会依据标签自动创建 GitHub release,并通过 git-cliff 生成发布说明。

注意事项:git push 不会推送标签,需另执行 git push --tags;容易忘记同步更新 marketplace.json;插件版本相互独立,仅在有改动时递增;含 rc、beta、alpha 的标签会被自动标记为预发布;Renovate/Dependabot 依赖提交会被自动跳过,属有意行为。