release

Release Workflow — 候选矩阵 → main/tag → 正式 Release

你是 UnitySkills 项目的正式发布助手。发布必须遵守以下顺序：

版本一致性检查
  → beta 候选提交完整矩阵
  → 用户确认正式发布
  → beta/main 精确同步
  → 创建并推送 annotated tag
  → tag 自身完整矩阵
  → 创建稳定 GitHub Release
  → 核验 releases/latest 与 Release 跳转地址

Unity 更新提醒只读取 GitHub releases/latest。因此在最后一步正式 Release 创建成功之前，不能宣称用户已经收到更新通知。

输入

用户可提供不带 v 的版本号，例如 /release 2.6.0；未提供时从 CHANGELOG.md 顶部最新的 ## [x.y.z] 解析。

• 版本必须严格为 MAJOR.MINOR.PATCH。
• tag 固定为 v{VERSION}。

阶段 1：只读预检查

1. 确认当前在 beta 分支。
2. 工作区必须完全干净：

   git status --porcelain
   

   有任何修改或未跟踪文件都停止，提示先提交或处理。
3. 检查 GitHub CLI 登录状态并获取最新远端引用：

   gh auth status
   git fetch origin main beta --tags
   

   任一失败都停止。
4. 将候选提交固定为变量并在整个流程中保持不变：

   RELEASE_SHA=$(git rev-parse beta)
   VERSION_TAG="v{VERSION}"
   

5. 确认本地 beta 没有遗漏远端提交，也没有基于过期的 main 发布：

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

   任一有输出都停止并列出提交。
6. 检查本地 main 是否存在未推送提交。后续会把本地 main 精确移动到候选提交；若存在必须先交给用户处理：

   git log origin/main..main --oneline
   

7. 验证项目版本锚点、CHANGELOG 顶部版本及 Release tag 格式一致：

   python3 .github/scripts/check_project_version.py . \
     --expected "{VERSION}" \
     --tag "${VERSION_TAG}"
   

8. 查询当前 GitHub 最新稳定 Release。候选版本必须严格高于它：

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

9. 同时确认本地 tag、远端 tag、GitHub Release 都不存在：

   git tag -l "${VERSION_TAG}"
   git ls-remote --tags origin \
     "refs/tags/${VERSION_TAG}" \
     "refs/tags/${VERSION_TAG}^{}"
   gh release view "${VERSION_TAG}"
   

   任一已存在都停止。绝不删除、移动或强制重推已发布 tag。

阶段 2：生成并审阅 Release Note

从 CHANGELOG 当前版本条目生成 .releases/v{VERSION}.md。该目录由 .gitignore 忽略。

格式：

# v{VERSION} — {一句话总结，提炼 2-4 个核心特性}

## ⭐ Highlights

- **{特性标题}**：{用户能获得的能力或修复}

## Added

{从 CHANGELOG Added 提炼}

## Changed

{从 CHANGELOG Changed 提炼}

## Fixed

{存在时加入}

## Docs

{存在时加入}

## Compatibility

{涉及 Unity 版本、可选包或破坏性变化时加入}

### 完整更改日志见 https://github.com/Besty0728/Unity-Skills/blob/main/CHANGELOG.md