这个 Skill 能做什么，适合哪些场景？
cmux-capture 是 cmux 仓库内置的一个 Agent Skill，教代理使用 `cmux shot` 和 `cmux record` 两条命令对 cmux 自己的窗口进行截图或录制。输出支持 png/jpeg/mp4/gif，可在正式版应用和 CI 中运行，全程不触发 macOS 屏幕录制权限请求。它只捕获 cmux 自己的窗口，其他应用即使盖在上面也不会出现在画面里。该技能适合“改动是视觉性的、文字说不清”的场景，例如拖拽、动画、布局变化等需要证据而非口头描述的场合。
- 用
cmux shot将 cmux 窗口输出为 png/jpeg，打印尺寸、字节数和路径 - 用
cmux record录制 mp4/gif 剪辑，支持 --max-seconds 自动停止（默认 15 秒，最长 120 秒） - 用
cmux record note在录制过程中把说明文字直接画进画面 - 用 --region x,y,w,h 在截图与录制间复用同一窗口坐标系，从剪辑回到静帧
- 通过 -- 拿到完整响应（含 fps_effective 等状态信息）
- 配合 scripts/pr-media.py 上传剪辑或将 mp4 转成 gif 用于 PR
- 开发者改动 UI 后，让代理在 PR 里附一张静帧截图证明布局正确
- 代理调整侧边栏拖拽或动画后，录一段 gif 让评审者直接看到过程
- CI dogfood 场景中用 record 步骤包裹关键步骤并加字幕，留下可回看的证据
- 评审者对口头描述存疑时，用同一 region 从剪辑中截出最终状态的静帧
- 代理自己录屏时设置 max-seconds，避免停止关注后剪辑一直挂着
- 非 macOS 用户：cmux 是仅限 macOS 的原生应用，本技能依赖 cmux CLI，其他平台无法使用
- 想捕获 cmux 之外应用画面的人：两个命令都只捕获 cmux 自己的窗口
- 不使用 cmux 终端、只截图任意屏幕区域的场景：请用系统自带截图工具
如何安装这个 Skill？
- 本评审为纯静态来源审读，未执行任何命令，所有分数置信度低。
- 该技能仅在 macOS 且已安装 cmux 应用时可用；未安装 cmux 时完全无法使用。
- 下载 cmux 依赖 GitHub Releases，中国大陆网络可能无法稳定访问。
- 仓库 license 元数据为 NOASSERTION，与 LICENSE 文件中的 GPL-3.0-or-later 不一致，使用前请自行确认许可。
- 发布者未经 FollowSkills 企业注册表验证，身份未知。
- 技能文档声明的能力与实现的一致性未经执行验证，使用时请以 --help 与实际行为为准。
- Shell / 命令行
- 本地文件系统
cmux macOS app with cmux CLI (macOS only)
该技能位于 manaflow-ai/cmux 仓库的 skills/cmux-capture/SKILL.md，是仓库捆绑的 25 个技能之一。源文档未给出专门的技能安装命令；前置条件是先安装 cmux 应用本身：
macOS（DMG / Homebrew，安装 cmux 主应用）
brew tap manaflow-ai/cmux
brew install --cask cmuxAgent Skills 标准做法是将 skills/cmux-capture 目录复制到你的代理客户端技能目录，具体路径取决于所用客户端，源文档未说明。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 我刚改了设置面板的布局，截一张 cmux 窗口的 png 放进 PR 描述里
- 录一段侧边栏拖拽的 gif，最长 8 秒，并在开始拖拽前加一条字幕
- 用 --region 0,0,420,900 先录 6 秒侧边栏，再截一张同区域的最终状态静帧
- 检查一下现在有没有录制在跑，如果没有就开始录工作区切换的动画
技能通过 SKILL.md 的描述被代理自动触发：当任务涉及视觉改动、无法用文字描述的拖拽/动画、或需要证据而非声明时使用。核心流程：
cmux shot --label settings-sheet
cmux shot --jpg --max-width 1200 --out ~/before.jpg
cmux record start --gif --max-seconds 8 --label sidebar-drag
cmux record note "dragging the workspace"
cmux record stop要点：静态内容用截图，随时间变化的内容（拖拽、动画、重排、应停止的 spinner）用录制；录制同一时间只能有一个，第二个 start 会返回 conflict；gif 已自动采用 8fps 和半缩放以保持体积小；--out 扩展名必须与格式匹配；CI 中可参考 cmux-testing/references/dogfood-scenarios.md 的 record 步骤表。更多细节见技能内的 references/commands.md。
这个 Skill 有哪些优点和局限？
- 全程无需 macOS 屏幕录制权限，也没有任何权限弹窗
- 在正式版和 CI 中都能工作，适合自动化验证
- 只捕获 cmux 窗口，其他应用遮挡也不影响画面
- 录制自动按 max-seconds 停止，避免剪辑挂起
- 截图与录制共用同一 region 坐标系，静帧与剪辑可互相转换
- 硬依赖 cmux 应用及 macOS，不适用于其他终端或其他平台
- 只能捕获 cmux 自己的窗口，无法截取系统其他部分
- 仓库许可证标注为 NOASSERTION（主体为 GPL-3.0-or-later，服务端为 BUSL 1.1），商用前需确认范围
- 技能的实际效果依赖本机安装 cmux，源文档未提供跨环境测试证据
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux-capture：cmux 窗口截图与录制 本页 | 55 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 共享行为规则 | 48 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 工作区操作技能 | 64 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 诊断 | 51 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 核心控制技能 | 47 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
cmux 官方 FAQ 将其与 tmux 对比：tmux 是运行在任意终端里的复用器，cmux 则是带 GUI 的原生 macOS 应用。就本技能而言，自然的替代品是 macOS 自带截屏（screencapture）和通用录屏工具，但后者需要屏幕录制权限且会截到整个屏幕；cmux-capture 的差异点是无权限、只捕获 cmux 窗口、可在 CI 中使用。
FollowSkills 如何评估这个 Skill？
技能仅描述对 cmux 自身窗口的截图/录屏，明确声明不涉及屏幕录制权限、不采集其他应用内容，输出路径与写入行为（隐藏兄弟文件、完成后原子替换、目录拒绝）披露充分，数据流透明，最小权限原则良好。扣分项：无独立发布者验证、仓库级 license 元数据为 NOASSERTION（虽 LICENSE 文件实际为 GPL-3.0-or-later）、技能本身未提供回滚或撤销已生成文件的说明。
文档高度自洽：参数表、错误码、限制范围、边界情况（region 超窗、gif 帧上限、扩展名不匹配）均有明确说明，失败模式可诊断且消息可读。但这是纯静态评审，未执行任何命令，未验证 happy path 或错误行为是否与实现一致，也未见到针对该 CLI 关键路径的测试证据，故不超过 10。
description 给出了明确的触发条件（视觉变更、拖拽/动画、评审需要证据），正文有 shot/record 选择指南、agent 注意事项和 CI 用法，场景清晰。扣分项：强依赖 macOS 与已安装的 cmux 应用，对没有 cmux 的环境完全不适用但未在技能内声明非适用边界；中国网络访问 GitHub Releases 下载应用可能受阻，未提示。
信息架构良好：主文档渐进披露到 references/commands.md，覆盖全部参数、响应字段与错误码，FAQ 式的选择指南实用。扣分项：技能无版本号或变更记录；仓库 license 元数据为 NOASSERTION 与实际 GPL-3.0-or-later 不一致；维护责任与更新路径仅间接来自仓库活跃度，未在技能内声明。
技能直接指导完成截图/录屏任务，示例命令可直接使用，输出格式（-- 字段、错误码）有完整定义，相比手动截图有明显附加价值（region 复用、caption、CI 集成）。但静态评审无法验证实际输出可用性，且前提是用户已安装 cmux，边际价值依赖该前提，故不高于 7。
关键声明可通过 cmux shot --help 交叉验证，仓库有真实 CI 工作流与测试基础设施，但未见覆盖 capture 关键路径的测试证据，无法独立复现执行结论。静态评审下限为 5，扣分因缺少针对该技能的第三方执行证据。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →