用途：为终端用户定制 cmux，涵盖终端、浏览器、Markdown、diff、文件预览、笔记、HTML 及右侧边栏查看器。核心原则是保留用户原有配置、优先使用 schema 支持的编辑方式，并在报告完成前进行验证。
主要能力与配置位置：应用偏好（外观、侧边栏、通知、浏览器路由、自动化、快捷键、新工作区位置）通过 cmux-settings 助手写入 ~/.config/cmux/cmux.json；自定义动作、工作区布局/命令、标签栏按钮、加号按钮行为、命令面板条目、通知钩子写入全局 ~/.config/cmux/cmux.json 或项目内 .cmux/cmux.json；Dock 控件（右侧边栏终端）写入 .cmux/dock.json 或 ~/.config/cmux/dock.json；终端渲染与键位（字体、主题、光标、复制即选、shell 集成）属于 Ghostty 配置，通常为 ~/.config/ghostty/config。查看器专属设置位于全局 cmux.json 的 browser.、markdown.、fileEditor.、fileExplorer.、diffViewer.*。
使用方式：先检查现有配置，再选择全局或项目本地范围（仓库相关命令默认项目本地，应用偏好默认全局）。文件已存在时先备份，例如 stamp="$(date +%Y%m%d-%H%M%S)" 后 cp -p 生成 .bak。应用设置与 cmux 自有快捷键使用助手命令：~/.agents/skills/cmux-settings/scripts/cmux-settings list-supported、set、validate。动作、UI 接线、工作区布局、通知钩子与 Dock 控件需手工编辑 JSONC，并保留无关段落。之后执行 cmux reload-config，并回读快捷键绑定或确认动作 ID 与出现位置。选择预设或模板前可运行 cmux docs workflows --json 查看已发布示例。
限制：不要整体覆盖顶层配置段；不要在动作、命令或提示中存放密钥；不要在生成的命令中使用 sleep 或时序规避；不要为 Ghostty 已负责的行为新增 cmux 设置；标签文字需足够短。若请求的查看器或开关不在 schema 中，应说明暂不支持，而非写入未知键；templates.<viewer> 面向未来笔记/Markdown/diff 定制的接口在 schema 与运行时实现前不可用。