开发与工程

cmux 共享行为规则

为 cmux 多入口行为制定统一的实现与验证规则,避免某个入口改了、其他入口仍是旧逻辑或旧 bug。

48/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 28k
最近更新
1 天前
License
NOASSERTION
cmuxterminal-multiplexeroptimistic-uibehavior-testing
+3climacosregression-testing

这个 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)生态,对其他仓库基本不适用。
  • 无版本号与变更记录,指令内容可能随仓库演进漂移。
开始前你需要
Agent 需要具备
  • 本地文件系统
需要预先安装
  • cmux (the macOS terminal app from manaflow-ai/cmux)

该技能位于 manaflow-ai/cmux 仓库的 skills/cmux-shared-behavior/ 目录(仓库共打包 25 个技能)。来源文档没有给出单独安装这个技能的命令——它随仓库分发,可克隆仓库后把该技能目录放入你的代理的技能目录。

通用方式:手动安装到 Claude Code(macOS / Linux)
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?

FollowSkills 评估 · FSRS-2.0
谨慎使用
48/ 100 五分制 2.4 / 5
1信任安全17 / 25 · 3.4/5

该技能是纯指导性文档,不请求任何权限、不执行脚本、不触网、不处理敏感数据,最小权限原则天然满足,无红线风险。但数据流、回滚等均为行为规范描述而非可验证机制,来源归属依赖仓库级 LICENSE(GPL-3.0-or-later,元数据为 NOASSERTION),发布者未经验证,故不给满分。

2可靠稳定8 / 20 · 2.0/5

指令自洽、无矛盾,三条规则(共享入口、乐观更新、补测覆盖)表述清晰且内部一致;但它是抽象行为准则,无脚本、无示例、无边界输入处理或失败反馈设计,静态评审下只能确认文案可读,不能确认关键路径可复现,扣分明显。

3适用触发6 / 15 · 2.0/5

触发描述较精确(多入口暴露的行为、快捷键/命令面板/CLI、乐观 UI、漏测 bug 场景),受众是 cmux 贡献者/代理;但未声明不适配边界、无输入输出示例,中文支持缺失,且技能价值完全绑定 cmux 生态(macOS 应用),对一般仓库不适用。

4规范维护8 / 15 · 2.7/5

name 与 description 与内容一致,结构简短清晰,仓库有 GPL-3.0 + BUSL 明确分层许可和活跃 CI 维护信号;但技能本身无版本号、无变更记录、无 FAQ/示例、无已知限制披露,技能文件级许可元数据为 NOASSERTION。

5有效结果6 / 15 · 2.0/5

作为编码规范型技能,其价值是把多入口一致性和乐观更新回滚规则注入代理行为,属合理且有边际价值的指导;但静态评审无法验证它实际改变产出质量,也无可核对的代表性输出,扣分。

6证据核验3 / 10 · 1.5/5

技能内容为作者主张的工程规范,无测试、无示例输出可独立复现;仓库整体 CI 与测试套件存在但未覆盖该技能自身的关键路径,仅有少量一级材料(SKILL.md、agents/openai.yaml)可审计。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年10月10日 审查版本 3dd1fe78859f 评估证据[1][2][3][4][5][6][7][8][9][10][11]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能需要 cmux 应用才能用吗?
技能文本本身可独立读取,但其规则只对修改 cmux 代码库有意义;不修改 cmux 源码则没有实际用途。
它是自动执行的吗?
不是。它是一份指令文档,没有脚本,效果取决于代理是否在相关任务中加载并遵循它。
"乐观更新"规则指什么?
指 UI 先行假设操作成功再确认的更新方式;技能要求全项目只用一条 mutation 路径,用请求 ID 或旧快照对账,失败时显式回滚,不允许各入口各维护一份乐观状态。
同一仓库的其他技能包含这些能力吗?
本仓库打包 25 个技能,本档案只覆盖 skills/cmux-shared-behavior/SKILL.md 这一个,不能据此推断其他技能的内容。

同仓库的其他 Skills

均来自 manaflow-ai/cmux

开发与工程

cmux 工作区操作技能

让 AI 代理安全地在调用它的 cmux 工作区内工作,避免误触用户正在查看的其他工作区或窗口。

★ 28k FS 64 推荐 1 天前
开发与工程

cmux 诊断

为 cmux 用户收集安全、只读的诊断信息,快速定位钩子、通知、会话恢复和 CLI 控制不工作的问题。

★ 28k FS 51 谨慎使用 1 天前
开发与工程

cmux 测试技能

为 cmux 仓库选择合适的本地/CI 验证方式,添加有行为依据的测试,并确保 Swift 测试文件在 Xcode 工程中正确接线。

★ 28k FS 60 推荐 1 天前
开发与工程

cmux 设置管理技能(cmux-settings)

安全查看、修改和回滚 cmux 终端的 cmux. 配置,改完即存即生效,无需重启应用。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux-browser:cmux 内置浏览器自动化技能

在不抢夺焦点的前提下,通过 cmux CLI 打开网页、探查浏览器表面、等待页面状态并提取数据,专为并行开发场景设计。

★ 28k FS 60 推荐 1 天前
自动化与运维

cmux Cloud 虚拟机技能

让 AI 代理通过 cmux CLI 操作云端虚拟机:在持久化的远程终端上运行长时命令和编码代理,并在完成后向用户展示结果工作区。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux-capture:cmux 窗口截图与录制

用一条 CLI 命令截图或录制 cmux 窗口,为 PR、bug 报告或视觉验证提供真实证据,且无需任何屏幕录制权限。

★ 28k FS 55 谨慎使用 1 天前
开发与工程

cmux 核心控制技能

通过 cmux CLI 确定性地控制多窗格终端布局——创建工作区、分割面板、移动与聚焦表面、触发提醒,专为 AI 编码代理的自动化而设计。

★ 28k FS 47 谨慎使用 1 天前
开发与工程

cmux 键盘快捷键定制

把你的按键习惯变成 cmux 的快捷键绑定:提供向导、模板与一键应用,避免误绑和冲突。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux Socket 策略规范技能

为 cmux 的 socket/CLI 命令开发提供线程调度与焦点行为规范,避免高遥测负载卡死主线程、避免自动化命令抢占用户焦点。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux 自定义技能

针对 cmux 终端的配置技能:安全地编辑 cmux.、Dock 配置与 Ghostty 偏好,定制动作、布局、快捷键和通知,而不破坏现有配置。

★ 28k FS 55 谨慎使用 1 天前
效率与协作

cmux Markdown 查看器

把 .md 文件在 cmux 终端旁的格式化面板中打开,文件一变就自动重渲染,让计划、文档和笔记始终可见。

★ 28k FS 52 谨慎使用 1 天前
开发与工程

cmux 自定义侧边栏

从一句自然语言需求生成可热重载的 cmux 自定义侧边栏,无需 Xcode、无需构建、无需签名。

★ 28k FS 50 谨慎使用 1 天前
开发与工程

cmux 开发工作流技能

为 cmux 贡献者提供原生构建、带标签开发包、Xcode 工程规范化与侧边栏扩展的标准化工作流,避免破坏正在运行的 cmux 会话。

★ 28k FS 53 谨慎使用 1 天前
自动化与运维

cmux Computer Use 技能

让 cmux 中的 AI 编码代理通过本地计算机使用引擎操作真实 macOS 应用,前提是用户明确提出请求。

★ 28k FS 50 谨慎使用 1 天前
开发与工程

cmux 调试技能

为 cmux(基于 Ghostty 的 macOS 终端)开发者提供调试日志、Debug 菜单、运行时陷阱和性能敏感路径的规范知识,避免在打字延迟敏感代码中引入卡顿。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux Ghostty 子模块工作流技能

为 cmux 贡献者提供 Ghostty 子模块与 GhosttyKit.xcframework 的标准化构建、推送与指针更新流程,避免子模块指针悬空导致的拉取失败。

★ 28k FS 54 谨慎使用 1 天前
开发与工程

cmux 架构规范技能

在向 cmux 添加或大幅改写 Swift 文件、包、协调器、服务或公共 API 之前,先加载这套包架构、分层、依赖倒置与 Swift 6 并发规则,避免违反项目约定。

★ 28k FS 63 推荐 1 天前
开发与工程

cmux 本地化规范与审计技能

在修改 cmux 任何用户可见文案时,强制执行本地化规则并跑完一条可核验的翻译审计流程,杜绝硬编码英文串。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux 发布助手

为 cmux 仓库维护者整理发版全流程:版本号递增、变更日志汇总、预发布守卫、打标签与产物校验,减少手工遗漏。

★ 28k FS 53 谨慎使用 1 天前

相关 Skills