SuperAPI AI 工具集

cmux-workspace

通用与其它

查看项目

更新于 10-15 16:41

技能介绍

用途:当任务需要限定在调用代理的 cmux 工作区内执行时使用本技能。cmux 中工作区是侧边栏标签式单元,内含分割窗格,每个窗格包含一个或多个表面(终端或浏览器会话)。默认只作用于调用者所在工作区,除非用户明确要求其他工作区、窗口或全局状态。

主要能力:识别当前上下文(cmux identify --json)、列举工作区/窗格/表面、以增量方式创建窗格与表面、在表面间移动内容、向调用终端发送命令,以及在侧边栏显示状态、进度与日志。辅助输出应复用调用终端右侧的 helper 窗格,无则新建一个;产物预览用 cmux open ... --no-focus 打开。

必要用法:优先读取 CMUX_WORKSPACE_ID、CMUX_SURFACE_ID、CMUX_SOCKET_PATH;缺失时用 cmux identify --json 并说明回退到当前焦点上下文。变更类命令尽量显式传 --workspace/--surface,创建与移动类命令传 --focus false。应用/运行时改动用带标签重载:./scripts/reload.sh --tag <short-tag>;若打印 Dev web origin,需在同一 worktree 启动 dev server 并 curl -fsS 验证。最终产物持久化到 /cmux-assets/<branch>/...,无法创建时用仓库内 cmux-assets/<branch>/...。

限制:未经用户明确要求,不得调用 select-workspace、focus-pane、focus-panel 或会改变焦点的 tab-action;不得关闭、聚焦、移动或向其他工作区发送输入。命令拒绝合法引用时应报告而非靠聚焦绕过。socket 访问可能关闭或受限,可先用 cmux capabilities --json 与 cmux ping 检查。drag-surface-to-split 存在已知问题。具体版本、收费与更多平台信息暂未提供。