这个 Skill 能做什么,适合哪些场景?
这是 manaflow-ai/cmux 仓库(一个基于 Ghostty 的 macOS 终端)中 25 个技能里的一个,路径为 skills/cmux-customization。它指导 AI 代理为最终用户定制 cmux:修改 cmux. 中的动作、自定义命令、工作区布局、标签栏按钮、Command Palette 条目、通知钩子,以及浏览器、Markdown、diff、文件预览等查看器的设置;涉及终端渲染时则改用 Ghostty 配置。技能强调备份、schema 支持的编辑和改后验证。它只适用于已安装 cmux 的 macOS 用户。
- 检查并备份 ~/.config/cmux/cmux. 和项目级 .cmux/cmux.,再按全局/项目作用域编辑
- 通过 cmux-settings 辅助脚本设置和验证应用偏好(浏览器路由、通知、快捷键等)
- 手工编辑 JSONC 配置 actions、ui.newWorkspace、ui.surfaceTabBar.buttons、commands 和 Dock 控件
- 终端字体、主题、光标等交给 Ghostty 配置(~/.config/ghostty/config),不重复发明 cmux 设置
- 用 cmux import <terminal> --dry-run 从 iTerm2、Alacritty、Kitty 等导入主题
- 改动后运行 cmux reload-config 并验证动作 ID、快捷键绑定或菜单入口确实生效
- 在多个仓库并行运行 Claude Code/Codex 的 macOS 开发者,想为特定项目定义工作区布局和自定义动作
- 团队成员想把 logs、测试监听、git TUI 等工具固定在右侧 Dock,并让配置随仓库走
- 从 iTerm2、Kitty、Warp 等迁移过来的用户,想把熟悉的字体和配色带入 cmux
- 想把常用操作加进 Command Palette、标签栏或加号按钮菜单的重度 cmux 用户
- 需要为 agent 钩子配置通知或调整浏览器打开路由的用户
- 非 macOS 用户:cmux 仅支持 macOS,本技能操作的配置全部依赖 cmux 应用
- 未安装 cmux 或 cmux CLI 的环境:技能中的 cmux-settings、cmux reload-config 等命令都无法执行
- 想直接改终端渲染而不了解 Ghostty 配置体系的用户——技能会把这些需求指回 Ghostty 配置文件
如何安装这个 Skill?
- 本技能依赖 macOS 专属的 cmux 应用及其 CLI/设置脚本,非 macOS 环境基本不可用;静态审查未执行任何命令,所有配置示例与 validate 流程均未经实际运行验证。
- cmux-settings 辅助脚本与 JSON schema 未随本技能捆绑,使用前请先运行 cmux-settings list-supported / validate 确认本机可用;仓库许可证为 GPL-3.0 与 BUSL-1.1 混合(web/ 等目录生产使用需商业授权),元数据显示 NOASSERTION,企业合规需自行核查。
- 技能在无确认环节下修改用户配置文件;虽有备份步骤,仍建议用户在重大改动前自行核对 ~/.config/cmux/ 与 ~/.config/ghostty/ 下的变更,且发布方未经 FollowSkills 注册表核实。
- Shell / 命令行
- 本地文件系统
cmux CLIcmux-settings helper scriptGhostty config (for terminal rendering)
来源未给出该技能本身的安装命令,仅提到可通过 skills.sh 安装(安装后脚本可能位于 ~/.agents/skills/ 或 ~/.codex/skills/ 下)。仓库中的技能集合需从 GitHub 获取 skills/ 目录;具体安装步骤请参考仓库文档,此处不做臆测。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/manaflow-ai/cmux.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/cmux-customization" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 帮我给当前项目加一个 Command Palette 动作,在当前窗格新标签里启动 Codex,并验证它在 ⌘⇧P 里能看到
- 把我的 logs 和测试监听器固定到右侧 Dock,写进 .cmux/dock. 让配置跟随仓库
- 我从 Kitty 迁移过来,先用 dry-run 预览把字体和配色导入 cmux
- 改一下加号按钮的默认行为,改成新建一个跑 dev server 的工作区,改完备份原配置并验证
技能由触发词激活(描述中列出:修改 cmux. 动作、自定义命令、工作区布局、加号按钮、标签栏按钮、Command Palette、Dock、快捷键、通知、浏览器路由、示例库预设或 Ghostty 偏好)。流程为:先读取现有配置,选择全局或项目作用域,备份已有文件,优先用 cmux-settings 做 schema 支持的编辑,手工编辑时保留无关段落,然后 cmux reload-config 并验证入口存在。可用 cmux docs workflows -- 查看官方示例目录,配合 references/examples.md 中的具体 JSON 配方。注意 templates.<viewer> 定制面尚未实现,schema 中没有的键不应写入。
这个 Skill 有哪些优点和局限?
- 强制备份和验证流程,降低配置损坏风险
- 明确区分全局与项目作用域,项目配置可随仓库共享
- 有查看器定制矩阵(references/viewer-types.md)和官方示例目录,减少猜测
- 诚实声明未实现的模板能力,避免写入无效键
- 强依赖 cmux 应用和 CLI,离开 macOS 不可用
- 部分查看器模板设置尚未发布,需要走回退路径
- JSONC 需手工编辑并保持无重复键,出错风险仍在
- 来源未提供该技能自身的测试或安装文档
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux 自定义技能 本页 | 55 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 键盘快捷键定制 | 58 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 设置管理技能(cmux-settings) | 58 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 工作区操作技能 | 64 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 自定义侧边栏 | 50 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
cmux 定位为 tmux 的图形化替代(原生 macOS 应用、垂直标签、内嵌浏览器、socket API,无前缀键),但两者也可配合使用:cmux 可通过 SSH 挂接远程 tmux 会话,并有 cmux local-tmux 提供本地 detach/reattach。
FollowSkills 如何评估这个 Skill?
技能只编辑用户本机配置文件(cmux.、dock.、Ghostty 配置),写入前有带时间戳的备份步骤(回滚可行),明确禁止在 actions/commands/prompts 中存放密钥、禁止发明未知 schema 键(fail closed)、导入操作提供 --dry-run 预览且不写用户既有 Ghostty 配置。扣分点:所有修改均无用户确认环节;依赖的 cmux-settings 辅助脚本与 schema 未随本技能提供,数据流与外部脚本行为不完全可审计。
工作流自洽:先检查文件存在、备份、编辑、validate、reload-config、读回验证;验证清单具体(JSON 解析、commandName 匹配、禁用 rightClick 别名),失败时要求保持文件不变并解释未支持面而非猜测键。扣分点:静态审查未执行任何命令,validate/reload 依赖本机安装 cmux 与 cmux-settings 的可用性,脚本缺失时的失败反馈无从验证,异常输入处理薄弱。
触发描述详细列举了适用动作(改 cmux.、快捷键、按钮、Dock、通知等),并明确非适用边界(Ghostty 已有的行为、notes 模板等尚未实现的 knob),场景与受众清晰。扣分点:目标是 macOS 专属 cmux 应用;中文支持仅靠仓库的 zh-CN README,技能正文全英文,核心功能依赖 macOS 终端生态,环境适配证据有限。
信息架构分层良好:SKILL.md 主文档 + viewer-types.md 矩阵 + examples.md 食谱,渐进披露清楚,已知限制(未实现的 templates 面、schema 边界)有披露并引用 issue/PR 编号。扣分点:仓库许可证元数据为 NOASSERTION(实际为 GPL-3.0 + BUSL-1.1 混合,需用户自行辨析),发布方未经注册表核实,技能自身无版本号或变更日志,更新路径未说明。
技能覆盖配置定制的完整闭环(定位→备份→编辑→验证→重载→确认),示例 JSON 直接可用,价值明显高于手工摸索配置路径。扣分点:静态审查无法确认示例与当前 schema 一致,输出正确性依赖 cmux-settings/validate 实际可用,且部分价值(如示例库预设)指向外部 cmux docs workflows,未经执行验证。
主要声明(配置路径、helper 用法、schema 权威来源 web/data/cmux.schema.、未来模板的 issue #4516 与 PR #14749)在文件内可溯源,引用具体可查。扣分点:静态审查未执行,无测试覆盖此技能关键路径的独立复现证据,示例仅在文档层面自证,事实与推断边界主要靠文档自身陈述。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →