这个 Skill 能做什么，适合哪些场景？
这是 manaflow-ai/cmux 仓库中 skills/cmux-settings 下的一个 Agent Skill，专门操作 cmux 的用户配置文件 ~/.config/cmux/cmux.（JSONC 格式）。它通过一个捆绑的辅助脚本读取、按点分 JSON 路径写入、校验并原子化保存配置，文件监听器会在保存后自动热加载，无需重启 cmux。技能内置模式校验、undo 回执、--preview 预览等安全机制，并明确禁止触碰 actions、ui、commands 等共享文件中的非设置区块。适合已经在使用 cmux 这款基于 Ghostty 的 macOS 终端的开发者。
- 用 cmux-settings path/dump/get 读取 cmux. 的路径、原文（保留注释）或指定键值
- 用 cmux-settings set/unset 按点分路径修改设置，值按 JSON 解析，写入前自动校验
- 用 cmux-settings validate 运行与应用相同的语义校验（未知路径、类型、枚举、边界）
- 用 --preview/--expect-revision/--receipt + undo 实现"写之前看效果、事后可回滚"的修改
- 用 list-supported 列出应用认识的全部设置键，shortcut 动作 ID 见 references/shortcut-actions.md
- 用 open 在 $EDITOR、VS Code、Cursor 或 TextEdit 中打开配置文件
- 正在用 cmux 跑多个 AI 编码代理，想把侧边栏细节、通知铃声、浏览器默认主页等偏好固化进配置文件
- 想改键盘快捷键（如把新标签绑定到 ctrl+b c），又怕凭记忆写错动作 ID
- 帮团队成员写一套可分发的 cmux 配置，需要先校验再落盘、必要时回滚
- 配置里含 workspaceGroups.byCwd 这类带点号的键，CLI 命令会拒绝，需要技能指导直接编辑文件
- 想把某个改动做成可卸载的预设（preset），通过 --receipt 生成可撤销回执
- 不用 cmux 终端的人——该技能只为 ~/.config/cmux/cmux. 服务，离开 cmux 毫无用处
- Linux/Windows 用户——cmux 目前仅支持 macOS
- 想改应用内部状态（浏览器 profile 导入、右侧边栏当前标签等运行时状态）的人——这些没有对应设置键，需用浏览器/侧边栏命令或设置面板
如何安装这个 Skill？
- 本评估为纯静态源码审阅，未执行任何脚本；helper 主脚本本体未在证据中提供，实际行为未经复现。
- references/all-keys.md 自认可能滞后于权威 schema，查找键值时应优先使用 list-supported 或 schema 而非该参考文件。
- 技能在写入前无用户确认环节，代理可直接修改用户配置；虽有 undo 机制，敏感场景建议人工复核。
- schema 经 raw.githubusercontent.com 获取，中国大陆网络环境下可能不可达，需注意失败时的行为。
- 目标环境为 macOS + 已安装的 cmux 应用，其他环境不适用；仓库许可为 GPL-3.0 与部分目录 BUSL-1.1 双轨制，license 元数据显示 NOASSERTION，商用前需自行核实。
- 发布者未经 FollowSkills 企业注册表验证，身份按未知处理。
- Shell / 命令行
- 本地文件系统
cmux app (macOS) with ~/.config/cmux/cmux.bundled cmux-settings helper script (or the installed cmux CLI)
来源未提供独立的技能安装命令；该技能是 cmux 仓库内 25 个技能之一。两种可用方式：
Codex（已安装路径，SKILL.md 中写明）：
~/.codex/skills/cmux-settings/scripts/cmux-settings <subcommand>任意 Agent Skills 客户端 / 从源码检出：
git clone https://github.com/manaflow-ai/cmux
cd cmux
git checkout skills/cmux-settings/SKILL.md
export PATH="$PWD/skills/cmux-settings/scripts:$PATH"前提是本机已安装 cmux 应用（DMG 或 brew install --cask cmux）并存在 ~/.config/cmux/cmux.。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 把 cmux 侧边栏背景改成跟随终端主题：cmux-settings set sidebarAppearance.matchTerminalBackground true，然后校验并告诉我如何撤销
- 我想在 cmux. 里关掉通知声音，先列出所有 notifications 相关键
- 帮我重绑 cmux 新建标签页快捷键为 ctrl+b c
- 用 --preview 看看把 app.appearance 设为 dark 会改什么，确认后帮我留下可撤销的回执
技能通过触发词激活：'cmux config'、'cmux.'、'change cmux setting'、'rebind a cmux shortcut' 或 '/cmux-settings' 命令。标准流程：先用 list-supported 查键，再 set 设置，然后读回并 validate。值按 JSON 解析（true、42、"text"、数组、对象），未加引号的普通词按字符串存储。
cmux-settings list-supported | rg -i 'sidebar.*terminal'
cmux-settings set sidebarAppearance.matchTerminalBackground true
cmux-settings validate
cmux-settings unset sidebarAppearance.matchTerminalBackground可回滚写法：bash
cmux-settings set app.appearance dark --preview
cmux-settings set app.appearance dark --receipt ~/private/undo.
cmux-settings undo ~/private/undo.
注意：set/unset 的 JSON 输出只代表已写入磁盘，不观测运行中的应用是否已重载；按点号拆分路径，键名本身含点号时这些命令会拒绝，需直接编辑文件。
这个 Skill 有哪些优点和局限？
- 写入前强制完整语义校验并原子写入，不会引入新的校验问题
- 文件监听器热加载，改完即生效，无需重启 cmux
- undo 回执 + --expect-revision 提供真正的可逆修改，回执文件权限为 0600
- 与 cmux CLI 的 config get/set/unset/toggle/cycle 及 preset 共用同一校验 schema 和写入路径
- 仅覆盖 cmux 的设置区块，actions/ui/commands/vault/rightSidebar 等非设置配置只能手动小心编辑
- 不含点号键名的键在 CLI 路径下无法编辑，需直接改文件
- 无独立版本号或发布渠道说明，与仓库其余 24 个技能捆绑维护
- license 标注为 NOASSERTION；仓库整体为 GPL-3.0-or-later，web/ 服务端为 BUSL-1.1，技能本身的许可未单独声明
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux 设置管理技能（cmux-settings） 本页 | 58 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 键盘快捷键定制 | 58 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 自定义技能 | 55 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 工作区操作技能 | 64 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 诊断 | 51 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
来源明确提到与其相对的替代方式：直接用 cmux config get|set|unset|toggle|cycle CLI（覆盖常见编辑但缺少 --preview、回执、undo 和自定义文件路径），以及手工编辑 cmux.（无校验，易踩坑）。技能本质上是把两者加上安全护栏的包装。
FollowSkills 如何评估这个 Skill？
证据显示该技能最小权限、仅编辑用户自己的 cmux.，写入前完整校验、原子写入、--preview/--receipt/undo 提供明确回滚路径，receipt 文件设为 0600 并提示含配置值需保密；扣分点：无用户确认步骤（助手可直接改写配置）、--file 可指向任意路径、外部 schema 经网络获取但未说明失败时的行为、发布者未经注册表验证。
SKILL.md 工作流自洽，错误反馈设计良好（conflict/invalid_config 结构化输出、undo_conflict 保留新值），JSONC 变异脚本处理了重复键、注释、换行等边角情况；扣分点：纯静态审阅无法执行复现，helper 主脚本本体未在证据中提供（仅见其引用的 Python 模块与消息文件），all-keys.md 自认可能滞后 schema，list-supported 依赖 Swift 源文件回退路径未验证。
frontmatter 触发词明确（/cmux-settings、cmux.、rebind shortcut 等），明确了非适用范围（viewer runtime/UI 状态、templates 提案、含点的键需手编），边界与触发条件较完整；扣分点：目标环境为 macOS + 已安装 cmux，未明确说明前置依赖检测或缺失时的失败指引，中文用户可达性无专门说明（schema 经 raw.githubusercontent.com 获取，该域名在中国大陆常不可达）。
文档分层良好（SKILL.md + references 矩阵 + schema 权威源 + 快速参考），命名稳定，有 Rules 节；扣分点：技能自身无版本号或变更记录，仓库 license 元数据为 NOASSERTION（实际为 GPL-3.0 + 部分目录 BUSL-1.1 双轨，需读者自行区分），all-keys.md 自认与 schema 不同步，维护责任与更新路径仅在仓库层面可见。
核心任务（查、改、校验、回滚 cmux 设置）流程完整，输出格式明确（JSON 结果、结构化错误），相对手动编辑 JSONC 有明显边际价值（保留注释、防覆盖非设置段、receipt 撤销）；扣分点：无执行证据证明输出可直接使用，示例值（如 computerUse.showInMenuBar）依赖 app 实际行为，静态审阅无法验证边际收益主张。
主要主张可追溯到仓库内材料（schema 路径、Swift 源文件、测试文件 tests/test_cmux_settings_supported_paths.py 的存在被声明、引用文档互相交叉）；扣分点：静态审阅无第三方执行证据、未提供 CI 或测试内容本身，引用文件（viewer-types.md、all-keys.md 完整内容）未全部随附，无法独立复核关键主张。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →