cmuxcmux/docs

技能

cmux 随附的技能会教编码代理使用 cmux CLI 控制、浏览器界面、Markdown 面板、调试窗口和发布流程。

安装

运行 skills.sh，将仓库中的技能安装到你的 Codex 技能目录。

从 GitHub 安装
curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux/main/skills.sh | bash
默认情况下，脚本会安装到 ~/.codex/skills，当设置了 CODEX_HOME 时会安装到 $CODEX_HOME/skills。如果你的代理从其他目录读取技能，请传入 --dest。

从 checkout 安装

在克隆的 cmux checkout 中，脚本会使用本地 skills 目录。

本地命令
./skills.sh
./skills.sh --list
./skills.sh --skill cmux --skill cmux-browser
./skills.sh --dest ~/.codex/skills
./skills.sh --dry-run

当脚本从 GitHub 下载时，使用 --ref 可以从指定 branch、tag 或 commit 安装。

curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux/main/skills.sh | bash -s -- --ref main

内置技能

每个技能都有一个 SKILL.md 文件、可选参考资料，以及 agents/openai.yaml 下的 OpenAI 元数据文件。

技能用途常用命令
cmux Core
skills/cmux/SKILL.md

通过 cmux CLI 控制窗口、工作区、面板、界面、焦点、移动、重排和路由。

当代理需要在多面板 cmux 布局中进行确定性的放置或导航时使用。

cmux identify --json
cmux Browser
skills/cmux-browser/SKILL.md

使用 snapshot 引用、DOM 操作、等待、截图和会话状态来自动化 cmux webview 界面。

用于应在 cmux 内运行的浏览器任务，而不是使用单独的浏览器自动化工具。

cmux browser surface:2 snapshot --interactive
cmux Markdown Viewer
skills/cmux-markdown/SKILL.md

在带实时重载的格式化 cmux 面板中打开 Markdown 文件。

用于在工作时把计划、文档、笔记和任务列表显示在终端旁边。

cmux markdown open plan.md
cmux Debug Windows
skills/cmux-debug-windows/SKILL.md

管理 Sidebar Debug、Background Debug、Menu Bar Extra Debug 和可复制的调试 snapshot。

在迭代调试窗口 UI 或从带标签的构建收集调试配置时使用。

skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh
cmux Release
skills/release/SKILL.md

运行 cmux 发布流程，从选择版本到 changelog、发布 PR、tag 和产物检查。

供准备或发布 cmux release 的 maintainers 使用。

./scripts/bump-version.sh

帮助菜单

macOS Help 菜单会镜像这个文档侧边栏，并包含 Skills。在 Help 中使用 Skills 项即可从应用打开此页面。

技能结构

保持主 SKILL.md 简洁。更详细的命令表、脚本和可复用模板应放在技能旁边。

skills/<name>/SKILL.md
skills/<name>/agents/openai.yaml
skills/<name>/references/*.md
skills/<name>/scripts/*
skills/<name>/templates/*
添加新技能时，请包含 agents/openai.yaml，这样安装器就能显示清晰名称、简短说明和默认 prompt。

相关文档