release

name	release
description	自动化项目的版本发布流程，包括版本号自增、ChangeLog 提取与汇总、代码提交、打标签以及推送到远程仓库。

Release Skill

此 Skill 旨在提供一个标准化的发布流程。它通过脚本自动处理繁琐的操作，并利用 AI 总结用户可感知的改动。

目录结构

• scripts/bump_version.py: 自动更新 pubspec.yaml 版本号。
• scripts/get_commits.py: 提取自上次发布以来的 Git 提交记录。
• scripts/format_release.py: 格式化发布日志模板。

使用流程

1. 准备阶段

   • 检查当前分支是否为发布分支（通常是 master/main）。
   • 确认工作区是干净的（没有未提交的改动）。

2. 版本号更新

   • 运行 python3 scripts/bump_version.py 或者带上目标版本 python3 scripts/bump_version.py 2.20.2-beta。
   • 如果用户提供了版本号，则使用用户指定的版本号，并且自动保留并增加构建号（例如从 +513 变为 +514）。
   • 如果未提供版本号，脚本会自动在当前版本号的基础上增加一个小版本号（patch），并同样增加构建号，且保留原有的 -beta 等预发布后缀。

3. 生成发布日志

   • 运行 python3 scripts/get_commits.py 获取原始提交记录。
   • 将记录提供给 AI，根据 scripts/format_release.py 的定义，总结出用户可感知的改动。
   • 改动分类应包括：🎉Highlights、✨新增功能、🐛修复问题、🔧性能优化、📋其它。架构优化和技术细节无需列入用户日志。
   • **非常重要：**如果某个分类下没有相关改动，必须直接省略该分类，绝对不要写“暂无”或“无”。
   • **非常重要：**生成的发布日志必须经过用户确认后，再进行 Commit 操作。

4. 提交与标注

   • 注意：在 Git 提交信息和打标签时，版本号必须省略 + 及其后面的构建号（例如：版本号 2.19.4+510 对应 2.19.4，版本号 2.20.2-beta+514 对应 2.20.2-beta）。pubspec.yaml 中则保留完整版本号。
   • 提交改动：# release: {基础版本号}\n\n{发布日志内容}。
   • 打标签：v{基础版本号}。

5. 推送

   • 将代码和标签推送到远程仓库：git push origin {branch} --tags。

注意事项

• 提交消息必须使用真实的换行，而不是 \n 字符串。
• 确认发布日志内容后，再进行 Commit 操作。