这个 Skill 能做什么,适合哪些场景?
这是 cmux 仓库内置的一个 Agent Skill,专门负责 cmux 终端的键盘快捷键定制。它读取 ~/.config/cmux/cmux. 中的 shortcuts.bindings,识别用户想改的动作,给出 tmux、Vim、浏览器风格等预设模板,再通过 cmux-settings 辅助脚本原子化写入并校验。它会先快照旧值、只改用户确认的路径,并在结束时给出精确的回滚命令。适用前提是你在 macOS 上使用 cmux 应用并有一个 cmux 检出或已安装 cmux-settings。
- 定位 cmux-settings 辅助脚本并读取 shortcuts.bindings 的现有绑定
- 将自然语言需求映射到合法的 action ID(校验自 shortcut-actions.md,不臆造)
- 提供并应用预设模板:Tmux Prefix、Vim Pane Navigation、Agent Triage、Workspace/Surface Lanes、Browser-Style 等
- 写入单键(如 cmd+b)或和弦(如 ["ctrl+b","c"])绑定,用 null 表示显式解绑
- 每次修改前快照旧值,结束后给出逐条 revert 命令
- 运行 cmux-settings validate 校验 JSON 与受支持的配置键,保存后 cmux 实时热重载
- 从 tmux 迁移到 cmux 的用户,想要 ctrl+b 前缀式的分屏与面板切换键位;重度 Vim 用户,想用 h/j/k/l 在无箭头键的布局里移动焦点;并行跑多个 AI 编码代理的用户,想把未读通知处理集中到一组 cmd+j 系按键上;浏览器键盘流用户,想让 Ctrl+W 只在终端焦点时关闭 surface 而不影响 vim/less/tmux;想审计或回滚现有 cmux. 覆盖项、恢复内置默认键位的用户。
- 不用 cmux(或不在 macOS 上)的用户——所有绑定写入的都是 cmux 的 cmux.,对其他终端或 tmux 本身无效
- 想要一键全量重写 shortcuts.bindings 的用户——本 skill 明确逐 action 修改,且 validate 不检测快捷键语法、macOS 保留键或焦点上下文冲突
- 希望 skill 替代 Settings UI 的用户——全局热键和 UI 保存的 UserDefaults 值仍需在 cmux 设置界面操作
如何安装这个 Skill?
- 本评估为静态源码审查,未执行任何命令;所有模板与验证行为均未经实际运行确认。
- cmux-settings 的 validate 不检查快捷键语法、macOS 保留键或焦点上下文冲突,冲突需用户自行在应用内确认。
- 技能仅适用于 macOS 上的 cmux 用户,且技能本身未声明中文支持;文档均为英文。
- 回滚依赖会话中保存的快照命令,用户需保留这些命令才能恢复原绑定。
- 许可证元数据为 NOASSERTION,仓库整体采用 GPL-3.0-or-later(部分目录为 BUSL-1.1),使用前请确认许可适用范围。
- unset 只清除文件管理的覆盖项,不重置 Settings UI/UserDefaults 中保存的更改,全局热键需通过 Settings > Global Hotkey 恢复。
- Shell / 命令行
- 本地文件系统
cmux app (macOS)cmux-settings helper script from the cmux checkout (skills/cmux-settings/scripts/cmux-settings)
源材料未提供该 skill 的独立安装命令;它位于 cmux 仓库内(skills/cmux-keyboard-shortcuts/SKILL.md),依赖同一仓库的 skills/cmux-settings/scripts/cmux-settings。常见做法是把整个 skills 目录交给支持 Agent Skills 的客户端:
git clone https://github.com/manaflow-ai/cmux.git脚本查找路径包括当前 cmux 检出、${CODEX_HOME}/skills 和 ~/.agents/skills,因此也可将 cmux-settings 放入这些位置:
mkdir -p ~/.agents/skills
cp -r cmux/skills/cmux-settings ~/.agents/skills/cmux 应用本体可通过 DMG 或 Homebrew 安装:
brew tap manaflow-ai/cmux
brew install --cask cmux如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 我想在 cmux 里用 tmux 风格的 ctrl+b 前缀来新建 surface 和分屏,帮我配上
- 把 cmux 的焦点切换改成 Vim 风格:不用方向键,用 cmd+opt+h/j/k/l 移动面板
- 审计一下我 ~/.config/cmux/cmux. 里的快捷键覆盖,列出哪些被解绑了
- 我并行跑了好几个 Claude Code 会话,给我一套 agent 未读通知的快捷键方案
当用户请求自定义、重绑、解绑、重置、审计或模板化 cmux 快捷键时,模型会触发此 skill。流程:先分类请求(一次性重绑 / 审计 / 重置 / 宽泛定制 / 指名风格),再用 cmux-settings 脚本读取与快照现有绑定,逐 action 应用修改(绝不整体覆盖 shortcuts.bindings),校验后读回确认,并汇报模板名、变更动作与 revert 命令。宽泛定制时它先给出 3-5 个模板让你选;指名 tmux/iTerm 等风格时先展示变更与冲突再批量应用。关键选项:null 表示显式解绑;showHideAllWindows 是唯一系统级快捷键(不能为和弦,需在 Settings 启用 Global Hotkey);cmd+1 代表 cmd+1~cmd+9 全族;保存 cmux. 即时热重载,无需重启。
这个 Skill 有哪些优点和局限?
- 模板精细且带冲突分析,如 cmd+[ / cmd+] 与浏览器前进后退的碰撞提醒
- 逐 action 修改并在修改前快照旧值,结束时给出精确 revert 命令
- 使用 cmux-settings 辅助脚本原子写入并校验 JSONC 与受支持键
- 区分文件托管覆盖、Settings UI/UserDefaults 与内置默认,避免把 unset 误称为真重置
- 强依赖 cmux 应用(macOS 专用)和 cmux-settings 脚本的存在与可执行权限
- cmux-settings validate 只验证 JSON 与受支持键,不检测快捷键语法、macOS 保留键或焦点上下文冲突
- 源材料未提供该 skill 的独立安装说明或测试套件
- 仓库 License 标注为 NOASSERTION:核心为 GPL-3.0-or-later,但 web/ 等服务端为 BUSL 1.1,商用需注意范围
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux 键盘快捷键定制 本页 | 58 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 设置管理技能(cmux-settings) | 58 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 自定义技能 | 55 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 工作区操作技能 | 64 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 诊断 | 51 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
与直接手改 ~/.config/cmux/cmux. 相比,这个 skill 增加了 action ID 校验、旧值快照、回滚命令和模板化布局,降低改错键位的风险。cmux 自带的 Settings > Keyboard Shortcuts > Base Keymap 预设处理 cmux/iTerm2/Terminal.app/tmux 风格;本 skill 的模板补足其余风格(Vim、Agent Triage、Browser-Style 等)。与 tmux 的 .tmux.conf 手工配置相比,这里由模型代劳映射与校验。
FollowSkills 如何评估这个 Skill?
技能仅通过 cmux-settings 辅助脚本读取/写入单一配置文件 ~/.config/cmux/cmux.,写入原子化并校验 JSON 与已知键;要求逐动作修改而非整体覆盖、先快照旧值并在结束时给出精确回滚命令,模板批量应用前需用户确认(除非用户点名模板),并主动披露 macOS 保留键等风险。扣分点:无独立执行验证,辅助脚本本体未在证据中展示,其验证能力被明确声明为有限(不检查快捷键语法或 macOS 冲突),回滚依赖用户保存快照,发布者身份未经验证。
工作流自洽:定位辅助脚本失败时有明确报错并退出,读取用 2>/dev/null 兜底,每步都有 validate 与读回确认;明确区分文件覆盖与 Settings UI/UserDefaults,并声明 validate 不能检测快捷键冲突,失败边界披露充分。扣分点:静态审查未执行任何命令路径,测试覆盖与异常输入行为无法确认,达到锚点上限。
description 触发词明确(customize/rebind/unbind/reset/audit/templates 及各命名风格),工作流按请求分类,边界声明细致(macOS 保留键、全局热键需单独启用、cmd+[ 与浏览器冲突、tmux alternate screen 场景),且核心功能完全本地、无网络依赖。扣分点:目标环境仅限 macOS cmux 用户,无中文支持说明,边界依赖交叉引用文件(shortcut-actions.md 等)而未在技能内完整呈现。
文档分层清晰:先决条件、模型、工作流、模板、规则递进展示;贡献者规则要求四处同步更新,展示了维护路径。扣分点:技能自身无版本号或变更日志,许可证元数据为 NOASSERTION(仓库整体为 GPL-3.0-or-later + 部分 BUSL,但技能路径无独立声明),无 FAQ,依赖的参考文件与脚本内容未随附。
输出直接可用:每条模板都是可直接执行的命令序列,结束时给出模板名、改动动作与回滚命令,比手工编辑 JSON 有明显边际价值,且强制读回校验。扣分点:静态审查无法验证实际执行结果与正确性,模板对配置 schema 的假设未经运行确认,达到静态锚点上限。
关键声明可追溯到仓库内具体文件(KeyboardShortcutSettings.swift、cmux-shortcuts.ts、docs 页面路径),仓库有真实 CI 工作流与测试基础设施。扣分点:未发现覆盖该技能关键路径的测试或第三方执行证据,各模板与行为声明仅有单一来源(技能文档自述),静态审查无法独立复现。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →