这个 Skill 能做什么,适合哪些场景?
cmux Core Control 是一个技能文件,教 AI 代理如何使用 cmux CLI 控制终端拓扑。cmux 是一款基于 Ghostty 的开源 macOS 终端应用,具有垂直标签页、分割面板和用于 AI 编码代理的通知功能。该技能将 window(窗口)、workspace(工作区)、pane(窗格)和 surface(表面,即窗格中的标签页)的概念定义为分层句柄模型,并提供了创建工作区、分割、移动/重排表面、运行工作区上下文菜单操作以及触发闪烁提示的具体命令。它适用于需要确定性地在多窗格布局中放置和导航的自动化场景。它仅为文档/指令型技能——没有脚本,所有的行为都通过 shell 命令发出。
- 运行
cmux identify --以自识别调用者在 window/workspace/pane/surface 层次结构中的上下文。 - 列出和创建拓扑元素:
list-windows、list-workspaces、list-panes、list-pane-surfaces、new-workspace、new-split、new-pane、new-surface。 - 通过
move-surface、split-off、reorder-surface移动和重排表面,并通过--focus标志路由焦点。 - 使用
--command <text>标志在新终端上启动初始命令(shell 保持活动状态)。 - 使用
workspace-action --action set-color|set-description|...自定义工作区,并使用trigger-flash --surface surface:N发出闪烁信号。 - 使用
cmux reload-config重新加载~/.config/cmux/cmux.和 Ghostty 配置,以及通过cmux browser ... download list检查浏览器下载历史。
- 运行并行 Claude Code/Codex 会话并希望代理自动将每个任务放置到专属的 workspace 或 split 中的开发人员。
- 构建布局脚本(例如在右侧窗格中打开开发服务器,在下方窗格中打开代理会话)的自动化工程师。
- 集成需要通知用户而无需打断的代理钩子——在特定表面上触发闪烁提示。
- 通过 CLI 重新排序或移动面板/标签页来重建或重组现有 cmux 布局的用户。
- 希望在 macOS 上直接从配置中验证调用上下文(哪个 pane/surface)的团队。
- 非 macOS 用户:cmux 是仅限 macOS 的原生 Swift/AppKit 应用,没有其他平台版本。
- 不运行 cmux 应用的人:每个命令都针对实时的 cmux 实例——仅使用 Ghostty、tmux 或 zellij 而不使用 cmux 的用户无法使用此技能。
- 没有 shell 执行权限的调用者:该技能完全由 CLI 命令组成,在没有 shell 访问权限的聊天式客户端中不可用。
如何安装这个 Skill?
- 技能依赖 macOS 上的 cmux 应用及 cmux CLI;未安装时技能不可用,使用前请确认环境。
- --command 会向新 shell 注入任意文本并由 shell 解释,组合不可信输入时存在命令注入面,请仅传入受控文本。
- 静态审查未执行任何命令;文档声称的行为与真实 CLI 行为需使用者自行验证。
- 技能元数据 license 为 NOASSERTION,仓库整体为 GPL-3.0(web/ 目录为 BUSL-1.1),商用合规请自行核对。
- 编辑 cmux. 前务必按文档建议做时间戳备份,避免配置损坏无法回滚。
- Shell / 命令行
- 本地文件系统
cmux macOS app (installed and running)
此技能位于 manaflow-ai/cmux monorepo 中的 skills/cmux/SKILL.md(该代码库集成了 25 个技能)。请按照主机常规的方式安装技能文件夹;安装步骤取决于主机,源代码未提供该技能的安装命令。Claude Code —— 将技能文件夹放置在您的技能目录中:
git clone https://github.com/manaflow-ai/cmux
# 将 skills/cmux/ 复制到您主机的 skills 目录中前提条件:安装 cmux 应用本身:
brew tap manaflow-ai/cmux
brew install --cask cmux如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 使用 cmux 创建一个新的工作区,在右侧窗格中运行 `npm run dev` 并聚焦它
- 列出我当前的窗口、工作区和窗格,然后告诉我正在哪个表面上运行
- 将表面 surface:7 移动到窗格 pane:2 中并将焦点放在那里,然后在其上触发闪烁
- 使用 cmux 将我当前的工作区重命名为 'Ship checklist' 并将其颜色设置为蓝色
当自动化需要确定性地放置或导航 cmux 布局时,主机代理会触发该技能。流程:使用 cmux identify -- 发现调用者的上下文,使用 list-* 命令枚举拓扑,然后使用 new-workspace / new-split / move-surface / reorder-surface / workspace-action / trigger-flash 对其进行修改。输出默认为短引用(window:N、workspace:N、pane:N、surface:N);传递 --id-format uuids|both 以获取 UUID。常用的选项:--command 仅在终端表面上接受(被 --type browser|simulator|agent-session 拒绝,被 new-workspace --layout 忽略);cmux reload-config 无需重启应用即可刷新 cmux. 和 Ghostty 配置。更深入的文档位于 references/ 文件夹中。
这个 Skill 有哪些优点和局限?
- 适用于所有布局操作的精确、确定性命令集,包括初始命令、焦点路由和重新排序。
- 清晰的句柄模型(window/workspace/pane/surface),使用短引用,支持可选的 UUID 输出。
- 通过 `references/` 文档和指向相关技能(设置、浏览器、工作区、捕获)的交叉引用进行了详细记录。
- 包含安全注意事项,例如在编辑前备份 `cmux.` 以及与 Ghostty 拥有的渲染设置的边界。
- 严格限制为 macOS + cmux 应用;没有它们,该技能就没有用处。
- 仅限于文档——没有脚本或测试,因此无法验证命令输出是否随 cmux 版本而变化。
- 存储库许可证被列为 NOASSERTION(代码库是 GPL-3.0-or-later,但服务器组件采用 BUSL 1.1),因此许可证分类需要检查。
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux 核心控制技能 本页 | 47 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 工作区操作技能 | 64 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 自定义侧边栏 | 50 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 设置管理技能(cmux-settings) | 58 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 自定义技能 | 55 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
cmux 明确地将自己与 tmux 进行比较:tmux 是在任何终端内部运行的终端复用器,而 cmux 是一款原生 macOS GUI 应用,具有垂直标签页、分割面板、嵌入式浏览器和 socket API。此技能控制 cmux 的 CLI,而不是 tmux 的前缀键界面。
FollowSkills 如何评估这个 Skill?
技能仅通过 cmux CLI 操作本地终端拓扑与配置,无网络外发、无凭据读取;文档明确要求编辑 cmux. 前先做时间戳 .bak 备份,并披露回退读取的旧配置路径,数据流较透明。扣分项:备份仅是建议而非强制隔离,--command 会向新 shell 注入任意文本,权限与确认机制未在技能层面说明,发布者未经注册表验证。
SKILL.md 与 references 文档对 --command 的行为(字面传递、空白忽略、类型冲突报错、远程 tmux 拒绝)描述自洽,句柄模型一致,命令示例彼此吻合。扣分项:静态审查无法执行验证,错误输出格式、异常输入下的失败反馈未见示例,边缘路径(identify 解析失败、健康检查失败后的行为)未覆盖。
场景明确(多窗格布局的确定性放置与导航),非适用范围有部分声明(仅 macOS、--command 的类型限制、远程 tmux 限制),语义触发条件在 description 中清晰。扣分项:依赖 cmux 应用与 CLI 在 PATH 上可用这一前提未在技能内声明,无中文支持说明,未讨论中国大陆网络可达性问题(本技能本身离线,影响较小)。
文档分层良好:SKILL.md 快速入门 + 五个专题 reference + 兄弟技能互链,表格化的 'When to Use' 体现渐进披露,仓库有 GPL-3.0 LICENSE、SECURITY.md 和真实 CI 工作流。扣分项:技能元数据 license 标为 NOASSERTION,技能自身无版本号或更新日志,维护责任与技能级更新路径未在技能内声明,共享仓库证据不能直接归到本技能。
声称的产出(通过 CLI 确定性控制窗口/工作区/窗格/表面)与文档命令一一对应,附 openai.yaml 接口描述,对自动化场景边际价值明确。扣分项:静态审查无法验证命令真实可用,无代表性输出示例或对照演示,价值主张依赖用户已安装 cmux 应用。
存在可审计的第一手材料(SKILL.md、references、agents/openai.yaml、LICENSE、SECURITY.md、CI 工作流),文档间可交叉印证。扣分项:静态审查不执行,仓库 CI/测试覆盖的是应用与 auth 包而非本技能的关键路径,无第三方独立复现证据,故按上限不超过 5 处理。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →