updateversion

Update Version — 安全更新项目版本 + 生成 CHANGELOG

你是 UnitySkills 项目的版本更新助手。此命令只负责准备一个可发布的版本候选；它不会创建 tag 或 GitHub Release，也不会立即向已安装用户发送更新提醒。

Unity 内的更新提醒使用 SkillsLogger.Version 与 GitHub releases/latest 的稳定 Release 比较。只有正式发布新的非 draft、非 prerelease GitHub Release 后，用户才会看到更新横幅，并跳转到该版本的 /releases/tag/v{VERSION} 页面。

输入

用户必须提供不带 v 的稳定语义版本号，例如 /updateversion 2.6.0。

• 只接受严格的 MAJOR.MINOR.PATCH。
• 不接受 v2.6.0、2.6、2.6.0-beta.1 或四段版本号。
• 未提供或格式不合法时停止，并提示：/updateversion <新版本号>。

步骤 1：远端与版本线预检查

1. 确认当前在 beta 分支；不在则停止。
2. 确认 GitHub CLI 已登录：

   gh auth status
   

3. 获取最新远端引用。任何 fetch 失败都必须停止，不能用过期的本地引用继续判断：

   git fetch origin main beta --tags
   

4. 检查工作区：

   git status --porcelain
   

   有未提交改动时明确警告，但不阻止，因为这些改动可能正是本次待发布内容。后续只修改约定的版本锚点，不覆盖其他改动。
5. 确认 beta 没有遗漏远端提交：

   git log beta..origin/beta --oneline
   git log beta..origin/main --oneline
   

   任一命令有输出都停止：本地 beta 落后于远端，必须先同步或处理分歧。
6. 从 origin/main 的 SkillsLogger.Version 读取当前稳定版本 {OLD_VER}，不要依赖可能过期的本地 main：

   git show origin/main:SkillsForUnity/Editor/Skills/SkillsLogger.cs
   

7. 查询 GitHub 当前最新稳定 Release：

   gh api repos/Besty0728/Unity-Skills/releases/latest \
     --jq '{tag_name,html_url,draft,prerelease}'
   

   • tag_name 必须严格为 vMAJOR.MINOR.PATCH。
   • 必须是非 draft、非 prerelease。
   • 正常情况下其版本应等于 {OLD_VER}；若不一致，停止并报告“main 当前版本与 latest Release 已错位”，不要猜测基准版本。
8. 验证当前工作树内的所有项目版本锚点仍等于 {OLD_VER}：

   python3 .github/scripts/check_project_version.py . --expected "{OLD_VER}"
   

   不一致时先修复已有漂移，不得继续批量升版。
9. 用数值元组比较语义版本。{NEW_VER} 必须严格高于 {OLD_VER}，也必须严格高于 GitHub latest Release 的版本；禁止使用字符串字典序比较。
10. 判定本次更迭级别 {BUMP_LEVEL} 并记录下来，步骤 4 与步骤 5 都依赖它：
    • 把 {OLD_VER} 与 {NEW_VER} 各自拆成 MAJOR.MINOR.PATCH 三段整数后逐段比较，不做字符串比较。
    • MAJOR 段不同 → major；MAJOR 相同而 MINOR 段不同 → minor；只有 PATCH 段不同 → patch。
    • 例：2.9.1 → 3.0.0 是 major；2.6.3 → 2.7.0 是 minor；2.3.1 → 2.3.2 是 patch。
    • 只有 major / minor 会让 .github/SECURITY.md 进入本次改动范围（见步骤 4）。