workmux Skills 完全指南：/worktree 与 /coordinator 像指挥 AI 团队一样委派任务
【免费下载链接】workmuxgit worktrees + tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmux
workmux 是一个用 git worktrees 和 tmux 窗口实现零摩擦并行开发的工具，而它的 Skills 才是真正的"指挥中心"：内置的/worktree和/coordinator技能让你像委派任务给 AI 团队一样，把需求一句话派发给多个并行的 worktree agent，由 AI 自动创建分支、执行任务、汇报状态并最终合并代码。本指南带你快速掌握这套 workmux Skills 完全指南，从零开始体验多智能体（multi-agent）并行开发。
一键安装 workmux Skills
Skills 是写给 AI agent 的"操作手册"，每个技能就是一个SKILL.md文件。workmux 内置了 6 个技能，安装只需一条命令：
workmux setup --skills它会自动检测你安装的 agent（Claude Code、OpenCode、Pi、Oh My Pi 等）并把技能复制到对应目录。技能的源文件都在仓库的 skills/ 目录下，并由 src/skills.rs 在编译时内嵌，升级 workmux 即可同步更新。
| 技能 | 作用 | 一句话定位 |
|---|---|---|
/workmux | 教 agent 使用 workmux CLI | 知识库 |
/worktree | 把任务委派给并行 worktree agent | 甩手掌柜 |
/coordinator | 全生命周期编排多个 agent | 团队指挥官 |
/merge | 提交、rebase、合并一步到位 | 收尾 |
/rebase | 智能冲突解决的 rebase | 收尾 |
/open-pr | 基于对话上下文写 PR 描述 | 收尾 |
/worktree 委派任务：一句话派出并行 AI 工人
/worktree的设计哲学非常鲜明：主 agent 只是调度员（dispatcher），绝不亲自写代码。它会为你写一份自包含的 prompt 文件，然后执行workmux add <分支名> -b -P <prompt文件>在后台创建新的 worktree，把完整上下文交给新 agent。
日常用法就这么简单：
> /worktree Implement user authentication > /worktree Fix the race condition in handler.go > /worktree Add dark mode, Implement caching # 一条消息派多个任务几个实用技巧：
--fork：把当前对话"分叉"给新 agent，保留完整讨论上下文，适合从当前会话衍生出新任务；-a <agent>：为不同任务指定不同的 AI，例如/worktree -a gemini ...；--merge：告诉新 agent 完成后自动执行/merge提交并合并。
每个被派出的 agent 都有独立的 git worktree、分支和终端，互不干扰，全部任务的状态会实时汇聚到侧边栏：
调度细节可以在 skills/worktree/SKILL.md 中查看，它还包括跨项目委派（--parent-session）等进阶能力。
/coordinator：让 AI 指挥 AI 的全自动编排
如果/worktree是"派完就走"，/coordinator则是常驻指挥官：它创建 agent、监控状态、发送后续指令、审阅产出，最后逐个触发合并——整个生命周期不用你插手。
它指挥团队的"遥控器"就是这几条 workmux 命令：
| 命令 | 用途 |
|---|---|
workmux add -b -P <file> | 后台生成 agent |
workmux status | 查看各 agent 状态（working / waiting / done） |
workmux wait | 阻塞等待，支持--any（谁先完成处理谁）和--timeout |
workmux capture | 读取 agent 的终端输出 |
workmux send | 给 agent 发补充指令或/merge |
workmux run | 直接在 agent 的 worktree 里跑 shell 命令 |
典型工作流是一个"扇出 / 扇入"（fan-out / fan-in）模式：
- 为每个任务写好自包含的 prompt 文件；
- 一次性在后台启动全部 agent；
- 用
workmux wait --status working确认启动成功； - 用
workmux wait --any等待"最先完成"的 agent，审阅后用workmux send <handle> "/merge"合并； - 重复直到所有任务合并完毕——完成的代码永远不会空闲等待。
一个让人眼前一亮的细节：agent 命令支持跨项目寻址。如果当前仓库找不到对应 handle，workmux 会全局搜索所有活跃 agent；重名时用project:handle语法区分，例如workmux send myproject:docs-update "also add the API reference"。
配合 dashboard 可以图形化监控所有被指挥的 agent：
完整编排规则（包括中断后如何恢复等待、为什么必须"一次合并一个"）都写在 skills/coordinator/SKILL.md 中。
/worktree 还是 /coordinator？怎么选
| 场景 | 推荐 | 理由 |
|---|---|---|
| 委派几个独立任务，稍后自己审查 | /worktree | fire-and-forget，立即回到当前会话 |
| 多步骤计划、任务有先后依赖 | /coordinator | 全自动管理等待、跟进、按顺序合并 |
| 想让 AI 完全托管、自己完全不动手 | /coordinator | 从生成到合并全程自动化 |
官方在 workflows 指南 中给出的建议是：当你已经有一个包含多个独立任务的计划时，直接把计划丢给/coordinator即可。
收尾三件套：/merge、/rebase 与 /open-pr
被委派的 agent 完成后，用配套的收尾技能干净利落地结束工作：
/merge：提交更改 → rebase 到基分支（智能解冲突）→workmux merge合并并清理 worktree、tmux 窗口和分支；/rebase：在合并前先同步基分支，冲突时会自动查看两边历史、尽力保留双方改动；/open-pr：基于对话上下文生成规范的 PR 描述，在浏览器中打开创建页供你最后确认。
三者源文件分别是 skills/merge/SKILL.md、skills/rebase/SKILL.md 和 skills/open-pr/SKILL.md，都带有注释模板，你可以按团队规范自由定制提交风格和冲突策略。
小结：把 AI 并行开发变成一条斜杠命令
workmux Skills 把"并行开发"这件原本需要手动管理分支、窗口和 agent 的复杂事，压缩成了两条斜杠命令：
/worktree—— 你是甩手掌柜，任务派出去，回头审查合并；/coordinator—— 你是甲方，AI 团队自己完成生成、监控、跟进、合并全流程。
更多技能细节可参考官方文档 Skills 指南。现在，试着给你的 AI 团队下达第一个任务吧！
【免费下载链接】workmuxgit worktrees + tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmux
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
