开发与工程

cmux 发布助手

为 cmux 仓库维护者整理发版全流程:版本号递增、变更日志汇总、预发布守卫、打标签与产物校验,减少手工遗漏。

53/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 28k
最近更新
1 天前
License
NOASSERTION
release-managementchangelogversion-bumpinggit-tagging
+3macosci-cdnotarization

这个 Skill 能做什么,适合哪些场景?

cmux-release 是 cmux 仓库内置的发布工作流技能,位于 skills/cmux-release/SKILL.md。它优先通过 /release 命令驱动:自动确定新版本号(默认 minor)、从各 PR 描述的 Changelog 小节汇总用户可见变更、更新 CHANGELOG.md、运行版本递增脚本与预发布守卫脚本,最后打 tag 并推送。该技能面向 cmux 项目自身的维护者,而非 cmux 终端的普通用户。

  • 运行 /release 流程:确定新版本(默认 minor)、抓取自上个稳定 tag 以来所有已合并 PR 的 Changelog 行、更新 CHANGELOG.md、提交、运行守卫脚本后打 tag 推送
  • 执行 ./scripts/bump-version.sh 递增 MARKETING_VERSION 与 CURRENT_PROJECT_VERSION(支持 minor/patch/major/显式版本号)
  • 用 GraphQL 一次性抓取已合并 PR,并用 changelog-lines.jq 分类:有效行收录、none 跳过、区间内的 revert 跳过、缺 Changelog 小节的 PR 列出待人工确认
  • 执行 ./scripts/release-pretag-guard.sh,失败时重新递增构建号并重试
  • 校验发布产物(cmux-macos.dmg 挂到 tag 上)与签名/公证所需的 GitHub secrets
适合
  • cmux 维护者准备一次新版本发布,想按项目既定流程自动汇总变更日志并打 tag
  • 发布时 pretag 守卫失败,需要弄清构建号递增的正确补救步骤
  • 评审某次发布该包含哪些 PR:确认 revert、缺失 Changelog 小节的 PR 如何归类
  • 排查发布产物未附加、签名或公证 CI 失败等资产层面的问题
不适合
  • 仅适用于 cmux 仓库本身——其他项目的发版流程不适用,除非照搬其脚本与约定
  • 不涉及应用功能开发;cmux 终端用户寻找使用帮助时应看 README 与官方文档
  • 依赖项目内的私有脚本(bump-version.sh、release-pretag-guard.sh)和内部等待工具 glaeda-gh,脱离该仓库无法独立运行

如何安装这个 Skill?

使用前请注意
  • 本评审为纯静态源码评审,未执行任何脚本或发布流程,结论置信度低。
  • 引用的关键脚本(bump-version.sh、release-pretag-guard.sh、notary-auth.sh)未包含在证据中,使用前应自行核对其行为。
  • 该技能仅适用于 cmux 仓库维护者,普通用户触发它没有意义;发布流程完全依赖 GitHub 与 Apple 服务。
  • 仓库 license 元数据为 NOASSERTION,实际为 GPL-3.0-or-later 与 BUSL-1.1 双许可,分发或复用相关脚本前需确认许可边界。
  • 发布涉及签名与公证 secrets,操作时应确认 secret 范围与临时密钥文件的清理符合预期。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
  • 本地文件系统
需要预先安装
  • cmux repository checkout
  • scripts/bump-version.sh
  • scripts/release-pretag-guard.sh
  • GitHub GraphQL access for changelog gathering

该技能随 cmux 仓库分发,位于 skills/cmux-release/,克隆仓库后即可供兼容 Agent Skills 的客户端读取。源材料未给出独立的安装命令,请勿假设存在 npm/pip 等安装方式。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/manaflow-ai/cmux.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/cmux-release" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 帮我准备下一次 cmux 发布,用默认 minor 版本号走 /release 流程
  • pretag 守卫失败了,按流程递增构建号并重试打 tag
  • 上个 v tag 到现在合并的 PR 里哪些没有 Changelog 小节需要人工补一下?
  • 确认这次发布的 cmux-macos.dmg 签名和公证 secrets 是否齐全

优先使用项目文档化的 /release 命令触发完整发版流程;技能本身在准备或排查 cmux 发布时被调用。核心流程:确认版本号后运行 bump 脚本,提交构建号变更,运行守卫脚本,再打 tag 推送:

./scripts/bump-version.sh          # 默认 minor
./scripts/release-pretag-guard.sh
git tag vX.Y.Z
git push origin vX.Y.Z

可选参数:bump-version.sh 支持 patch、major 或显式版本号(如 1.0.0)。tag 推送会创建 CI run,用运行 ID 观察而非轮询 GitHub。签名需要 APPLE_CERTIFICATE_BASE64 等 secrets,公证需要 ASC_API_* 密钥。

这个 Skill 有哪些优点和局限?

优点
  • 把 cmux 发版约定(Changelog 由 PR 描述聚合、构建号必须递增、守卫脚本前置)固化为可执行流程,减少人工遗漏
  • 对 revert、无 Changelog 小节的 PR 等边界情况有明确分类与人工确认机制
  • 文档详实,含发布检查清单引用与失败排查指引
局限
  • 高度绑定 cmux 仓库的脚本、secrets 与内部工具(glaeda-gh),无法直接迁移到其他项目
  • GPL-3.0-or-later 许可(服务端为 BSL 1.1),纳入他处工作流需注意合规
  • 签名/公证环节依赖未在本技能内验证的 GitHub secrets 配置,出问题时需按引用文档排查

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
cmux 发布助手 本页 53 · 谨慎使用 ★ 28k 1 天前 NOASSERTION
通用发布工作流 51 · 谨慎使用 ★ 4.3k 18 天前 MIT
DeepChat 版本发布助手 46 · 谨慎使用 ★ 6.4k 3 天前 Apache-2.0
ORCH — AI 智能体编排器 49 · 谨慎使用 ★ 170 2 个月前 MIT
Bump Version — AionUi 版本发布自动化技能 38 · 不推荐 ★ 33k 1 个月前 Apache-2.0

源材料未列出替代方案。与通用的语义化版本/发布 Action(如手动打 tag 流程)相比,本技能的特点是 Changelog 直接从 PR 描述聚合而非要求改动 CHANGELOG.md,但仅覆盖 cmux 自身的发版路径。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
53/ 100 五分制 2.7 / 5
1信任安全15 / 25 · 3.0/5

该技能面向 cmux 仓库维护者的发布流程,文档明确披露了签名与公证所需的 GitHub secrets(APPLE_CERTIFICATE_*、ASC_API_*)及密钥临时文件的 mode-600 处理和删除方式,数据流透明度较好;但 bump-version.sh、release-pretag-guard.sh 等关键脚本未在证据中提供,回滚路径仅部分描述,发布者身份未经注册库验证,仓库 license 元数据为 NOASSERTION,故未达满分。无恶意行为或隐藏数据外传迹象。

2可靠稳定10 / 20 · 2.5/5

指令自洽,命令序列明确,release-checklist.md 提供了详细的失败分类处理(pretag guard 失败、签名/公证失败、夜间公证恢复流程),失败反馈质量较高;但静态评审无法执行,bump-version.sh 与 pretag guard 脚本本体缺失,无法确认可复现性,按静态校准上限计 10。

3适用触发9 / 15 · 3.0/5

触发条件在 description 中清晰(准备或排查 cmux 发布时使用),受众明确为 cmux 维护者,边界隐含清晰(不适用于非本仓库);但主要面向内部工作流,对 FollowSkills 中国用户而言核心依赖 GitHub Actions、Apple 公证与 glaeda-gh 工具,可及性与适用面有限,扣分计 9。

4规范维护9 / 15 · 3.0/5

文档分层良好(SKILL.md 主流程 + references/checklist + openai.yaml 元数据),安装依赖与失败处理有说明,仓库实际含 GPL-3.0-or-later 与 BUSL-1.1 双许可且 LICENSE 全文可查;但技能自身的版本号、变更日志与明确维护责任声明缺失,license 元数据 NOASSERTION 与实际许可不符,扣分计 9。

5有效结果6 / 15 · 2.0/5

核心任务(版本提升、changelog 聚合、pretag 守卫、打标签、资产预期)描述完整且附带判断标准与失败恢复,边际价值高于人工记忆操作;但静态评审无法验证产出的直接可用性,脚本未随证据提供,按静态校准低于上限计 6。

6证据核验4 / 10 · 2.0/5

存在可追溯的引用(release.md、changelog-lines.jq、release-checklist.md、CI workflow 文件、scripts 路径),仓库含真实 CI 工作流佐证执行环境;但静态评审无法独立复现发布流程,引用的脚本与命令文件不在证据范围内,覆盖率薄,计 4。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年10月10日 审查版本 3dd1fe78859f 评估证据[1][2][3][4][5][6][7][8][9][10][11][12]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

普通 cmux 用户需要这个技能吗?
不需要。它服务于 cmux 仓库的维护者发版流程;用户只需从 release 下载 cmux-macos.dmg 或用 Homebrew 安装即可。
为什么 Feature PR 不直接改 CHANGELOG.md?
项目约定每个 PR 描述带一个 ## Changelog 小节(一行 Added/Changed/Fixed/Removed 或 none),发布时由 /release 通过 GraphQL 批量抓取并聚合,docs 的 changelog 页面直接渲染 CHANGELOG.md,无需另行维护。
pretag 守卫失败怎么办?
按技能指引重新运行 ./scripts/bump-version.sh 递增构建号,提交后重试——构建号必须递增,否则 Sparkle 自动更新会失效。
发布产物和签名依赖什么?
产物是挂在 tag 上的 cmux-macos.dmg;签名需 APPLE_CERTIFICATE_BASE64、APPLE_CERTIFICATE_PASSWORD、APPLE_SIGNING_IDENTITY 三个 secrets,CI 公证通过 App Store Connect API key 完成。

同仓库的其他 Skills

均来自 manaflow-ai/cmux

开发与工程

cmux 工作区操作技能

让 AI 代理安全地在调用它的 cmux 工作区内工作,避免误触用户正在查看的其他工作区或窗口。

★ 28k FS 64 推荐 1 天前
开发与工程

cmux-browser:cmux 内置浏览器自动化技能

在不抢夺焦点的前提下,通过 cmux CLI 打开网页、探查浏览器表面、等待页面状态并提取数据,专为并行开发场景设计。

★ 28k FS 60 推荐 1 天前
开发与工程

cmux 测试技能

为 cmux 仓库选择合适的本地/CI 验证方式,添加有行为依据的测试,并确保 Swift 测试文件在 Xcode 工程中正确接线。

★ 28k FS 60 推荐 1 天前
开发与工程

cmux 设置管理技能(cmux-settings)

安全查看、修改和回滚 cmux 终端的 cmux. 配置,改完即存即生效,无需重启应用。

★ 28k FS 58 推荐 1 天前
自动化与运维

cmux Cloud 虚拟机技能

让 AI 代理通过 cmux CLI 操作云端虚拟机:在持久化的远程终端上运行长时命令和编码代理,并在完成后向用户展示结果工作区。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux-capture:cmux 窗口截图与录制

用一条 CLI 命令截图或录制 cmux 窗口,为 PR、bug 报告或视觉验证提供真实证据,且无需任何屏幕录制权限。

★ 28k FS 55 谨慎使用 1 天前
开发与工程

cmux Ghostty 子模块工作流技能

为 cmux 贡献者提供 Ghostty 子模块与 GhosttyKit.xcframework 的标准化构建、推送与指针更新流程,避免子模块指针悬空导致的拉取失败。

★ 28k FS 54 谨慎使用 1 天前
开发与工程

cmux 核心控制技能

通过 cmux CLI 确定性地控制多窗格终端布局——创建工作区、分割面板、移动与聚焦表面、触发提醒,专为 AI 编码代理的自动化而设计。

★ 28k FS 47 谨慎使用 1 天前
开发与工程

cmux 架构规范技能

在向 cmux 添加或大幅改写 Swift 文件、包、协调器、服务或公共 API 之前,先加载这套包架构、分层、依赖倒置与 Swift 6 并发规则,避免违反项目约定。

★ 28k FS 63 推荐 1 天前
开发与工程

cmux 键盘快捷键定制

把你的按键习惯变成 cmux 的快捷键绑定:提供向导、模板与一键应用,避免误绑和冲突。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux Socket 策略规范技能

为 cmux 的 socket/CLI 命令开发提供线程调度与焦点行为规范,避免高遥测负载卡死主线程、避免自动化命令抢占用户焦点。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux 调试技能

为 cmux(基于 Ghostty 的 macOS 终端)开发者提供调试日志、Debug 菜单、运行时陷阱和性能敏感路径的规范知识,避免在打字延迟敏感代码中引入卡顿。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux 本地化规范与审计技能

在修改 cmux 任何用户可见文案时,强制执行本地化规则并跑完一条可核验的翻译审计流程,杜绝硬编码英文串。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux 自定义技能

针对 cmux 终端的配置技能:安全地编辑 cmux.、Dock 配置与 Ghostty 偏好,定制动作、布局、快捷键和通知,而不破坏现有配置。

★ 28k FS 55 谨慎使用 1 天前
开发与工程

cmux 开发工作流技能

为 cmux 贡献者提供原生构建、带标签开发包、Xcode 工程规范化与侧边栏扩展的标准化工作流,避免破坏正在运行的 cmux 会话。

★ 28k FS 53 谨慎使用 1 天前
效率与协作

cmux Markdown 查看器

把 .md 文件在 cmux 终端旁的格式化面板中打开,文件一变就自动重渲染,让计划、文档和笔记始终可见。

★ 28k FS 52 谨慎使用 1 天前
开发与工程

cmux 诊断

为 cmux 用户收集安全、只读的诊断信息,快速定位钩子、通知、会话恢复和 CLI 控制不工作的问题。

★ 28k FS 51 谨慎使用 1 天前
自动化与运维

cmux Computer Use 技能

让 cmux 中的 AI 编码代理通过本地计算机使用引擎操作真实 macOS 应用,前提是用户明确提出请求。

★ 28k FS 50 谨慎使用 1 天前
开发与工程

cmux 自定义侧边栏

从一句自然语言需求生成可热重载的 cmux 自定义侧边栏,无需 Xcode、无需构建、无需签名。

★ 28k FS 50 谨慎使用 1 天前
开发与工程

cmux 共享行为规则

为 cmux 多入口行为制定统一的实现与验证规则,避免某个入口改了、其他入口仍是旧逻辑或旧 bug。

★ 28k FS 48 谨慎使用 1 天前

相关 Skills