这个 Skill 能做什么，适合哪些场景？
这是 manaflow-ai/cmux 仓库（共 25 个技能）中的一个技能，位于 skills/cmux-custom-sidebar/SKILL.md。它指导 AI 编程代理根据用户的口头描述（如"一个显示我所有工作区的侧边栏"）直接写出并启用一个 SwiftUI 风格的侧边栏文件，放在 ~/.config/cmux/sidebars/ 下。该文件在运行时由 cmux 解释执行，保存即热重载，可绑定工作区、标签页、git 分支、PR、端口和时钟等实时数据，并通过点击调用 cmux 命令。前置条件是 macOS 上已安装 cmux 应用并开启 Custom sidebars 测试版开关。
- 根据自然语言描述，在 ~/.config/cmux/sidebars/<name>.swift 写出一个 SwiftUI 风格的侧边栏视图文件（单个视图表达式，无 struct/imports）
- 指导开启 Settings > Beta features > Custom sidebars（customSidebars.beta.enabled）测试版开关
- 运行 cmux sidebar validate <name> 做解析校验，再 cmux sidebar select <name> 启用，保存后热重载迭代
- 绑定只读实时上下文（约每秒刷新）：workspaces（分支、PR、端口、状态、标签页）、clock 等
- 用 Button/onTapGesture 调用 cmux("workspace.select" 等方法，让侧边栏行可点击操作
- 用 Reorderable 实现可持久化的拖拽排序，并按支持的子集约束布局与列表长度
- 并行跑多个 Claude Code / Codex 会话的 macOS 开发者，想用一个侧边栏总览所有工作区并一键跳转
- 想在侧边栏一眼看到每个工作区的 git 分支、PR 状态、监听端口和未读通知的用户
- 希望侧边栏顶部显示时钟、日期等自定义信息的用户
- 想给工作区列表加拖拽排序并持久化的重度 cmux 用户
- 不想学 SwiftUI 或装 Xcode，只想"口述需求"就得到一个可用侧边栏的用户
- 非 macOS 用户：cmux 目前只支持 macOS，此技能完全依赖 cmux 应用
- 想要侧边栏内双向编辑（输入框、开关、滑块）的场景：@State 与输入控件尚不支持
- 不想使用测试版功能或拒绝 GPL-3.0-or-later 许可约束的用户
如何安装这个 Skill？
- 侧边栏文件保存即热重载并可能执行真实 cmux 命令，生成内容请人工过目后再启用；
- 技能要求从 raw.githubusercontent.com 拉取文档，大陆网络环境下该步骤可能失败，建议使用 `cmux docs sidebars` 本地命令作为首选；
- 宿主 cmux 应用仅支持 macOS 且当前为 beta 功能，非 macOS 或未开启 beta 的环境不适用；
- 仓库许可证标注为 NOASSERTION（实际为 GPL-3.0 与 BUSL 混合），商业使用前请核对许可边界；
- 静态审查未执行任何命令，validate/hot-reload 行为均未独立验证。
- Shell / 命令行
- 网络访问
- 本地文件系统
cmux app (macOS)cmux CLI~/.config/cmux/sidebars/ directory
技能文件位于 manaflow-ai/cmux 仓库的 skills/cmux-custom-sidebar/SKILL.md。源材料未给出该技能的专用安装命令（例如市场或 CLI 一键安装），也未说明如何把仓库中的技能复制到各代理的技能目录；请参考仓库贡献指南或代理的技能安装文档获取实际步骤。前置条件是先安装 cmux 应用本体：
macOS（Homebrew，cmux 应用本体）
brew tap manaflow-ai/cmux
brew install --cask cmuxmacOS（DMG）
# 从 GitHub Releases 下载 cmux-macos.dmg 并拖入 Applications安装 cmux 应用后，在 cmux 中开启测试版
# Settings > Beta features > Custom sidebars (customSidebars.beta.enabled)如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 帮我做一个侧边栏，显示我所有 cmux 工作区和未读通知，点击就能跳转
- 做一个带时钟和当前工作区分支名的 cmux 侧边栏
- 我想要一个能拖拽排序、显示每个工作区 PR 状态的侧边栏
- 把我的侧边栏列表限制到前 20 行，按状态排序
用户用自然语言描述想要的侧边栏（例如"一个显示我工作区、PR 和时钟的侧边栏"），代理触发此技能后按以下流程执行：
cmux docs sidebars
cmux sidebar validate <name>
cmux sidebar select <name>
cmux sidebar reload流程：先确认测试版开关已开启；在 ~/.config/cmux/sidebars/ 下写一个 kebab-case 命名的 .swift 文件（动态内容优先用 .swift 而非静态 .）；用 validate 校验、select 启用；保存即热重载，验证数据显示和点击行为后再交付。可选项包括 Reorderable 拖拽排序、.prefix(20) 截断长列表（侧边栏约每秒重估一次）、openURL 打开链接。完整支持的视图/修饰符/数据字段用 cmux docs sidebars 查看。
这个 Skill 有哪些优点和局限？
- 无需 Xcode、构建或签名，一个 SwiftUI 风格文件即可在运行时解释执行
- 保存即热重载，校验错误内联显示且失败保存保留上一个可用渲染
- 绑定真实 cmux 状态（工作区、git、PR、端口、时钟）且约每秒刷新
- 点击行可执行真实的 cmux 命令，而不只是静态展示
- 硬依赖 cmux 应用和其 Custom sidebars 测试版开关，非 macOS 无法使用
- 不支持 @State、输入控件（TextField/Toggle/Slider/Picker）、自定义 struct/View、sheet/popover、AsyncImage，双向编辑尚不可用
- 不支持或不完全支持的语法会被静默跳过，可能出现半空白侧边栏
- 源材料中未提供该技能自身的测试套件或安装命令说明
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux 自定义侧边栏 本页 | 50 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 工作区操作技能 | 64 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 调试技能 | 56 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 自定义技能 | 55 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 核心控制技能 | 47 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
仓库将 cmux 与 tmux 对比：tmux 是运行在任意终端内的多路复用器，cmux 则是自带垂直标签页、分屏、内嵌浏览器和套接字 API 的原生 macOS 应用。本技能在这一对比之上提供了 tmux 没有的能力：用 SwiftUI 风格文件自定义侧边栏界面。
FollowSkills 如何评估这个 Skill？
该 skill 只写用户自己的 ~/.config/cmux/sidebars/ 文件，操作面小且可逆（删除文件即可回滚）；通过 curl 拉取 docs/custom-sidebars.md 属外部依赖但来源是同一仓库，数据流基本透明；侧边栏按钮会真实执行 cmux(...) 命令，属于用户自建内容运行，无恶意痕迹。扣分点：热重载意味着文件保存即生效，无显式确认步骤；文档获取步骤混用 `cmux docs` 与公网 curl，未说明缓存/校验；无验证发布者归属信息。
SKILL.md 自身高度自洽：命名、beta 开关、validate/select、热重载、故障排查逐项对应；'unsupported syntax is skipped gracefully' 与 'broken save keeps last working render' 给出了受控失败模式。扣分点：静态审查无法执行 `cmux sidebar validate` 等关键路径，仓库 CI 不覆盖 sidebar 解释器与该文档的对应关系；错误信息质量仅有文字承诺。
frontmatter 的触发描述非常精确（custom sidebar、workspaces/tabs/PRs/clock、~/.config/cmux/sidebars/ 路径触发），并明确列出尚不支持的功能子集（@State、TextField、双向编辑等），边界清晰。扣分点：硬性依赖 macOS 专属 cmux 应用，未声明中文支持，且核心功能随应用分发，海外下载渠道对大陆用户可达性有限。
文档分层良好：工作流摘要 + 指向完整契约（cmux docs sidebars），含快速上手示例、实时数据字段表、故障排查四条。扣分点：仓库元数据 License 为 NOASSERTION（实际为 GPL-3.0 + BUSL 混合，对 skill 文件本身归属不完全明确）；skill 无版本号/changelog；beta 功能的稳定性与弃用路径未说明。
目标明确（从自然语言生成可用侧边栏文件），给出可直接复制的 quick start 示例，且 validate 命令提供真实数据形状检查，边际价值高于手写。扣分点：静态审查无法验证示例文件在真实 cmux 渲染器中可直接使用；效果依赖 beta 开关状态，输出完整性证据有限。
有可审计的原始材料：SKILL.md 全文、示例代码、字段 schema 均在仓库内可核对，仓库另有真实 CI 与测试套件。扣分点：CI/测试不覆盖本 skill 的关键路径（sidebar 解释器与文档一致性），无第三方对渲染结果的独立佐证，事实与推断的界限依赖单一来源。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →