这个 Skill 能做什么，适合哪些场景？
这是 manaflow-ai/cmux 仓库中 skills/cmux-dev-workflow/SKILL.md 定义的一个贡献者技能，面向在本地开发和验证 cmux 原生应用变更的场景。它规定了如何用带标签的构建（reload.sh --tag）隔离 bundle ID、套接字和构建产物，如何运行 scripts/setup.sh 与 verify-local.py 等脚本，以及如何处理 Xcode 工程文件规范化和侧边栏扩展的标签管理。技能强调安全边界：只能从受信任的 checkout 运行仓库命令，绝不操作用户正在运行的 cmux 实例。适合 cmux 的代码贡献者，对普通用户或非 macOS 开发者没有用处。
- 运行 ./scripts/setup.sh 初始化子模块、构建 GhosttyKit 并安装工程规范化 pre-commit 钩子
- 通过 ./scripts/reload.sh --tag <short-tag> 构建带标签的开发包（不启动），需要时加 --launch
- 用 CMUX_TAG=<tag> scripts/cmux-debug-cli.sh list-workspaces 验证标签构建
- 运行 python3 scripts/verify-local.py 及其 --only project 等范围检查
- 通过 scripts/reload-extension.sh --tag <tag> 构建与宿主匹配的侧边栏扩展
- 规范化 project.pbxproj 并在 tests/test-execution.toml 中注册新 Python 测试
- cmux 贡献者修改了原生应用或构建输入，需要用带标签的本地构建验证，同时不干扰正在运行的 cmux 会话
- 贡献者只想改文档或可移植工具，用 verify-local.py 的范围检查快速反馈，跳过无关的应用构建
- 贡献者编辑了 Xcode 工程文件（如工具链 pin），需要运行工程规范化钩子和 --only project 检查
- 开发者需要为某个标签构建并验证侧边栏扩展，保持扩展点 ID、bundle-ID 后缀与显示名后缀一致
- 想在 cmux 里运行 AI 编码代理的普通终端用户——本技能只服务 cmux 自身的开发
- 非 macOS 或不打算改 cmux 代码库的人；构建需要 Xcode、GhosttyKit 子模块和本地 checkout
如何安装这个 Skill？
- 静态审查未执行任何脚本；reload.sh、reload-extension.sh、cmux-debug-cli.sh 等引用脚本的实际行为与失败反馈未经验证。
- 仓库 License 元数据为 NOASSERTION，实际为 GPL-3.0 与 BUSL-1.1 混合许可，使用前请自行确认适用范围。
- 技能强约束（如禁止替换运行中的应用）依赖脚本实现，建议使用前抽查相应脚本的守护逻辑。
- 面向 macOS/Xcode 贡献者，场景较窄；无中文文档；默认命令会加载仓库代码，务必在可信检出中运行。
- 标签化构建在本仓库之外需要 cmuxterm-hq 的共享 dev backend，外部贡献者需先阅读 CONTRIBUTING 的相关限制。
- Shell / 命令行
- 本地文件系统
macOSXcode (pinned via .xcode-version)Python 3cmux repository checkout
本技能属于 manaflow-ai/cmux 仓库自带的技能集合（仓库共捆绑 25 个技能），安装方式即克隆仓库并在支持的 Agent Skills 客户端中指向 skills/cmux-dev-workflow/。源材料未给出针对 Claude Code、Codex 等具体客户端的一键安装命令：
git clone https://github.com/manaflow-ai/cmux.git
cd cmux
# 将 skills/cmux-dev-workflow/ 安装到你的 Agent Skills 客户端（源材料未文档化具体命令）如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 我改了原生构建输入，帮我用短标签 reload 构建一个开发包并验证 workspaces 列表
- 只改了文档，运行 verify-local.py 的对应范围检查，别触发应用构建
- 我把 project.pbxproj 的工具链 pin 改了，跑一下工程规范化检查
- 为标签 dev-42 构建侧边栏扩展并核对扩展点 ID、bundle-ID 后缀和显示名后缀
技能通过 SKILL.md 的 description 在涉及原生构建输入、本地环境搭建或带标签应用验证的任务时被触发。核心流程：先从受信任的 checkout 运行（连 --help 都会加载仓库代码）；用 python3 scripts/verify-local.py 做快速反馈；只有原生变更才走带标签构建：
./scripts/setup.sh
./scripts/reload.sh --tag <short-tag>
CMUX_TAG=<short-tag> scripts/cmux-debug-cli.sh list-workspacesreload.sh 默认只构建不启动，加 --launch 做活体验证。禁止裸 xcodebuild、打开未打标签的 cmux DEV.app、使用 /tmp/cmux-cli，或对用户正在运行的 com.cmuxterm.app 执行退出/重启/xctrace --launch。工程文件改动后运行 python3 scripts/verify-local.py --only project。
这个 Skill 有哪些优点和局限？
- 以标签隔离 bundle ID、套接字和构建产物，多会话并行开发不互相污染
- 明确的安全边界：保护用户正在运行的 cmux 及其活跃代理会话
- 提供 verify-local.py 范围化检查，避免文档改动也触发完整应用构建
- 工程规范化钩子自动注册新 Python 测试到 tests/test-execution.toml
- 强依赖 macOS、Xcode（Intel/macOS 14 回退用 Xcode 16.2/Swift 6.0）和本地完整 checkout
- 仅覆盖 cmux 自身开发工作流，对仓库外部项目毫无用处
- 技能本身不含自动化测试证据；错误操作（如碰运行中实例）的后果较重，依赖文档约束
- 仓库 License 标注为 NOASSERTION，实际为 GPL-3.0-or-later 加服务器部分 BUSL-1.1，商用需核实
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux 开发工作流技能 本页 | 53 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 测试技能 | 60 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 自定义侧边栏 | 50 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 工作区操作技能 | 64 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux-browser：cmux 内置浏览器自动化技能 | 60 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
该技能没有直接竞品可比；它本质上是 cmux 仓库的内部贡献指南脚本化，与 tmux 等终端复用器不在同一维度。
FollowSkills 如何评估这个 Skill？
技能自身展现了良好的最小权限与隔离意识：强制标签化构建隔离 bundle ID/socket，明确禁止杀死或替换用户正在运行的 cmux 及其活跃 agent 会话，覆盖开关 CMUX_ALLOW_REPLACING_RUNNING_CMUX 明示仅用户可设，并提醒即便 --help 也加载仓库代码（信任边界提示）。扣分项：这些保护由未在本次审查中的脚本实现、无法静态核验；仓库 License 元数据为 NOASSERTION（实际为 GPL+BUSL 混合），发布者未经验证；无显式回滚机制说明。
指令自洽且交叉引用一致（tagged-builds.md、sidebar-extension-tagging.md、SKILL.md 间约定吻合），对异常路径有较清晰说明（--build-only 不可与 --launch 组合、helper 缺 CMUX_TAG 会拒绝运行）。扣分项：静态审查未执行任何脚本，无法复现关键路径；脚本的失败反馈质量与边界用例覆盖无法证实，按校准上限不超过 10。
受众与场景明确（cmux 原生构建贡献者），声明了能力边界（app 构建不等于测试目标编译/执行，指向测试指南），非适用范围（可移植静态检查无需 setup）有说明。扣分项：触发条件靠描述性提示而非精确语义规则；仅限 macOS/Xcode 环境，无中文支持；依赖共享 dev backend 时对仓库外贡献者有限制。
信息架构分层良好（SKILL.md 精简、细节下沉到 references/），渐进披露清晰，安装/依赖说明存在。扣分项：License 元数据 NOASSERTION 与实际混合许可未在技能内说明；技能本身无版本号或变更记录；维护责任与更新路径依赖仓库整体而未明示。
任务（安全地本地构建、验证标签化 app、扩展侧边栏插件）路径具体、命令可直接使用，相比无指导的裸 xcodebuild 有明显边际价值（避免破坏用户运行中的应用）。扣分项：静态审查无法验证输出可直接使用；部分前提（本地 backend 模式、预构建 GhosttyKit 下载验证）未端到端证实。
仓库含真实 CI 工作流（app-host 测试、Xcode pin CI 守护）与提交的测试，为主要声明提供部分可审计佐证。扣分项：这些证据未直接覆盖本技能的关键路径（reload.sh、reload-extension.sh、cmux-debug-cli.sh 未提供测试或第三方执行证据），静态审查下上限为 5，未达则扣。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →