Unity-Skills: Command for Claude Code

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

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

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

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

beta 与 main 是两条平行线：Star History 机器人的图表提交只落 main，beta 永远不接收，也不为此把 main 合并或变基进 beta。发布时 main 被移动到候选提交，这些图表提交随之丢弃，阶段 10 再重新生成。

输入

用户可提供不带 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 没有遗漏远端提交；origin/main 相对 beta 只允许多出 Star History 图表提交：

   git log beta..origin/beta --oneline
   git log --format='%h %an %s' beta..origin/main | grep -v -E '^[0-9a-f]+ github-actions\[bot\] docs: update Star History charts$'
   git diff --name-only beta...origin/main | grep -v -x -E 'docs/star-history-(light|dark)\.svg'
   

   任一有输出都停止并列出提交。
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。