这个 Skill 能做什么,适合哪些场景?
这个技能是 manaflow-ai/cmux 仓库中的一份行为约定文档,面向在 cmux(一款基于 Ghostty 的 macOS 终端)代码库中工作的开发者或编码代理。它规定了三类规则:当同一行为暴露在多个入口(快捷键、命令面板、右键菜单、CLI/socket、设置、调试菜单)时,必须实现一条共享的 action/model 路径;乐观更新必须只保留一条 mutation 路径,用请求 ID 或旧快照记录待定状态并在失败时回滚;当用户反馈测试漏掉了 bug 时,必须先围绕确切复现路径补上行为级测试再宣布修复完成。它不含脚本,只是可被代理读取并遵循的指令文本。
- 识别同一功能涉及的全部入口面(快捷键、命令面板、右键菜单、CLI/socket 命令、设置界面、调试菜单),要求走一条共享 action/model 路径
- 禁止只修一个入口而其他入口保留重复逻辑
- 规定乐观更新的统一写法:用请求 ID 或前一份快照记录待定状态,以权威结果对账,失败时显式回滚或进入错误状态
- 当用户说"测试漏了一个 bug"时,要求先按确切复现路径增补行为级测试覆盖,才能宣称修复完成
- 在 cmux 仓库里给某个功能加新入口(例如给设置项补一个命令面板入口)的代理,需要知道必须复用共享路径而不是复制逻辑
- 修复一个涉及乐观 UI 更新的 bug,需要一条明确的 mutation 路径和回滚约定
- 用户报告某个 bug 被测试漏掉时,代理需要按规范先补行为级测试再交付修复
- 代码评审时检查一个改动是否只修了单一入口而遗漏了其他入口
- 不适用于 cmux 之外的项目——规则中的入口清单(调试菜单、CLI/socket 命令等)是按 cmux 自身结构写的
- 不面向终端用户或日常使用 cmux 终端的人,这是面向修改 cmux 代码的贡献者/代理的约定
如何安装这个 Skill?
- 本评审为静态源码评审,未执行任何内容,置信度为低。
- 该技能是行为规范文档,不含脚本或测试;其效果取决于代理是否遵循指令,无法静态验证。
- 技能文件级许可元数据为 NOASSERTION,实际许可需参照仓库级 GPL-3.0-or-later(web/ 等目录为 BUSL-1.1)。
- 发布者未经 FollowSkills 注册表验证,身份未知。
- 内容为英文,无中文支持;技能价值绑定 cmux(macOS)生态,对其他仓库基本不适用。
- 无版本号与变更记录,指令内容可能随仓库演进漂移。
- 本地文件系统
cmux (the macOS terminal app from manaflow-ai/cmux)
该技能位于 manaflow-ai/cmux 仓库的 skills/cmux-shared-behavior/ 目录(仓库共打包 25 个技能)。来源文档没有给出单独安装这个技能的命令——它随仓库分发,可克隆仓库后把该技能目录放入你的代理的技能目录。
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/manaflow-ai/cmux.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/cmux-shared-behavior" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 我要给 cmux 的通知清理功能加一个命令面板入口,按 cmux-shared-behavior 的规则应该怎么做?
- 用户说我们的测试漏掉了一个 split pane 大小调整的 bug,帮我按共享行为规则先补上复现路径的行为级测试
- 这个设置项的乐观更新目前在快捷键和 CLI 两条路径上重复实现了,请按共享 mutation 路径的规则重构
技能通过其 description 触发:当任务涉及"一个行为暴露在多个入口"、"乐观更新"或"测试漏掉了 bug"时,代理应加载此技能并遵循其中的规则。典型流程:代理在修改 cmux 行为前,先检查该行为涉及哪些入口面,确保只实现一条共享 action/model 路径并逐一验证每个入口;涉及乐观更新时遵循单一 mutation 路径约定;修复被报告漏测的 bug 时先补复现路径的行为级测试。技能本身没有可运行的脚本或命令。
这个 Skill 有哪些优点和局限?
- 规则具体且可执行:明确了入口清单、mutation 路径写法和漏测 bug 的处理流程
- 轻量纯文本,任何能读文件的代理都可遵循,无运行时依赖
- 源自 cmux 实际代码库的维护约定,针对该仓库真实存在的一类问题(多入口逻辑重复)
- 仅适用于 cmux 代码库,对其他项目几乎无迁移价值
- 纯约定文档,没有配套脚本或自动化检查来强制执行
- 仓库许可证标注为 NOASSERTION,技能文件本身的许可范围需自行确认
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux 共享行为规则 本页 | 48 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 工作区操作技能 | 64 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 诊断 | 51 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 测试技能 | 60 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 设置管理技能(cmux-settings) | 58 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
与通用的代码风格或测试规范类技能不同,它是针对单个应用(cmux)的架构级行为约定;cmux 的多入口设计与 tmux 等纯 CLI 多路复用器不同,这份规则正是为了在 GUI + CLI 双入口场景下保持一致性。
FollowSkills 如何评估这个 Skill?
该技能是纯指导性文档,不请求任何权限、不执行脚本、不触网、不处理敏感数据,最小权限原则天然满足,无红线风险。但数据流、回滚等均为行为规范描述而非可验证机制,来源归属依赖仓库级 LICENSE(GPL-3.0-or-later,元数据为 NOASSERTION),发布者未经验证,故不给满分。
指令自洽、无矛盾,三条规则(共享入口、乐观更新、补测覆盖)表述清晰且内部一致;但它是抽象行为准则,无脚本、无示例、无边界输入处理或失败反馈设计,静态评审下只能确认文案可读,不能确认关键路径可复现,扣分明显。
触发描述较精确(多入口暴露的行为、快捷键/命令面板/CLI、乐观 UI、漏测 bug 场景),受众是 cmux 贡献者/代理;但未声明不适配边界、无输入输出示例,中文支持缺失,且技能价值完全绑定 cmux 生态(macOS 应用),对一般仓库不适用。
name 与 description 与内容一致,结构简短清晰,仓库有 GPL-3.0 + BUSL 明确分层许可和活跃 CI 维护信号;但技能本身无版本号、无变更记录、无 FAQ/示例、无已知限制披露,技能文件级许可元数据为 NOASSERTION。
作为编码规范型技能,其价值是把多入口一致性和乐观更新回滚规则注入代理行为,属合理且有边际价值的指导;但静态评审无法验证它实际改变产出质量,也无可核对的代表性输出,扣分。
技能内容为作者主张的工程规范,无测试、无示例输出可独立复现;仓库整体 CI 与测试套件存在但未覆盖该技能自身的关键路径,仅有少量一级材料(SKILL.md、agents/openai.yaml)可审计。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →