SKILL.md
只读
名称
cmux-release
描述
cmux 的发布工作流指南，涵盖版本号递增、更新 changelog、预打标签校验（pretag guard）、发布 tag 创建以及 release 产物规范。适用于准备发布或排查 cmux 发布问题时使用。
cmux 发布指南
推荐优先使用 /release 命令。该命令会自动确定新版本号（默认递增次版本号 minor）、收集自上一 tag 以来的 commit 记录、更新 CHANGELOG.md、运行 ./scripts/bump-version.sh、提交代码、运行 ./scripts/release-pretag-guard.sh，最后打 tag 并 push 到远程。
文档中的 changelog 页面（位于 web/app/[locale]/(landing)/docs/changelog/page.tsx）直接由 CHANGELOG.md 渲染而成，因此无需单独更新其他文档日志源。
版本号递增
./scripts/bump-version.sh # minor (0.15.0 -> 0.16.0)
./scripts/bump-version.sh patch # 0.15.0 -> 0.15.1
./scripts/bump-version.sh major # 0.15.0 -> 1.0.0
./scripts/bump-version.sh 1.0.0 # 指定具体版本号
该脚本会更新 MARKETING_VERSION 和 CURRENT_PROJECT_VERSION。构建版本号（build number）会自动递增；为确保 Sparkle 自动更新功能正常工作，构建版本号必须保持增长。除非有明确的特殊要求，否则默认递增 minor 次版本号。
打 Tag 标签
./scripts/release-pretag-guard.sh
git tag vX.Y.Z
git push origin vX.Y.Z
gh run watch --repo manaflow-ai/cmux
如果 pretag guard 校验失败，请重新运行 ./scripts/bump-version.sh，提交 build number 递增的变更后再试。
发布产物与密钥 (Secrets)
- 发布产物为
cmux-macos.dmg，附在对应的 tag 发布中。README 中的下载按钮统一指向releases/latest/download/cmux-macos.dmg。 - 代码签名与公证（Notarization）需要配置以下 GitHub Secrets：
APPLE_CERTIFICATE_BASE64、APPLE_CERTIFICATE_PASSWORD、APPLE_SIGNING_IDENTITY、APPLE_ID、APPLE_APP_SPECIFIC_PASSWORD和APPLE_TEAM_ID。
详细参考文档
- references/release-checklist.md：包含 changelog 语气规范、发布失败排查指引以及产物重命名关联影响。
