cmux 工作区操作技能

这个 Skill 能做什么，适合哪些场景？

cmux-workspace 是 manaflow-ai/cmux 仓库中 25 个技能之一，教代理如何在 cmux（一款基于 Ghostty 的 macOS 终端）中定位并操作调用它的工作区。它定义了窗口、工作区、面板、表面等概念模型，并规定了默认作用域规则：只对调用者工作区执行操作。技能强调非干扰式自动化——绝不随意调用改变焦点的命令，布局构建采用一次性加式命令，并通过 `cmux agent message` 与其他代理通信而非直接向其终端键入。核心依赖是 cmux CLI、套接字访问和 CMUX_* 环境变量。

• 读取 CMUX_WORKSPACE_ID、CMUX_SURFACE_ID、CMUX_SOCKET_PATH 环境变量，缺失时回退到 cmux identify -- 确认当前上下文
• 用 cmux new-pane、cmux new-surface 以一次性加式命令创建分栏和表面，避免先建后移再聚焦的链条
• 通过 cmux send / cmux send-key 向调用者终端发送命令和按键
• 用 cmux agent message / cmux agent inbox 在代理之间传递消息，经代理钩子唤醒空闲的 Claude Code 会话
• 用 cmux set-status、set-progress、log 更新侧边栏状态，用 cmux move-surface --focus false 移动表面而不抢焦点
• 通过 CMUX_SOCKET_PATH 指定套接字，用 cmux capabilities 和 cmux ping 排查连接问题

如何安装这个 Skill？

本技能随 manaflow-ai/cmux 仓库发布，路径为 skills/cmux-workspace/。仓库 README 未给出单独安装某个技能的命令，仅说明技能是可复用工作流集合（另有 cmux-skills 集合和 https://cmux.com/docs/skills 文档）。安装 cmux 应用本身：

macOS（Homebrew）

brew tap manaflow-ai/cmux
brew install --cask cmux

macOS（DMG）
从 GitHub Releases 下载 cmux-macos.dmg 并拖入应用程序文件夹。

如何使用这个 Skill？

技能由代理在 cmux 工作区内运行时自动可用，触发场景包括工作区、面板、表面、套接字定位及非干扰自动化等请求。核心流程：先用 cmux identify -- 确认调用者上下文；默认只作用于调用者工作区，变更类操作显式传 --workspace / --surface；绝不调用 focus-pane、focus-panel、select-workspace 等改变焦点的动词；创建面板时优先用 --command 或 --url 一次到位，支持处传 --focus false：

cmux new-pane --workspace "${CMUX_WORKSPACE_ID}" --type browser --direction right --url "http://127.0.0.1:8765"
cmux send --surface "${CMUX_SURFACE_ID:-}" "git status\n"
cmux agent message cmux-remote-status "修复已在主干，有空时变基。"

若命令拒绝了有效的 surface: 或 pane: 引用，应报告错误并停止，而不是通过聚焦来绕过。

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

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

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

常见问题