Appearance
dmux-workflows Skill 是 Everything Claude Code 的核心并行编排能力,基于 tmux 多 pane 管理,将 Claude Code、Codex、OpenCode 等多种 AI Agent 工作流并行化。它适用于需要多 Agent 协作、任务拆分、跨工具链并行开发的场景,通过 dmux 快速开启、合并和管理多路 Agent 会话,大幅提升 AI 编程助手的生产效率。支持 git worktree 隔离、自动化脚本集成,并可扩展到大规模多 Agent 流水线。
Everything Claude Code Dmux Workflows Skill:tmux 多 pane 并行编排 Claude Code、Codex、OpenCode 等 Agent
在 AI 辅助编程逐渐成为主流的今天,如何高效协作、并行推进多任务,成为开发者团队和个人提升效率的关键。Everything Claude Code 的 dmux-workflows Skill,正是为此场景量身打造:它通过 tmux 多 pane 管理,将 Claude Code、Codex、OpenCode 等多种 AI Agent 的会话并行化,支持复杂任务的拆分、团队协作和自动化集成。
本文将详细介绍 dmux-workflows Skill 的核心价值、激活条件、操作流程、典型用法、输出示例,以及与其他 Agent/Skill 的协作关系,帮助你在实际项目中系统性提升 AI 编程效率。
1. dmux-workflows Skill 能解决什么问题?
传统做法的局限:
- 单一 Agent 会话串行处理,遇到复杂任务(如同时开发多个模块、并行测试与修复、跨工具链协作)时效率低下。
- 多 Agent 协作时,容易出现上下文冲突、文件覆盖、token 消耗不可控等问题。
- 手动管理多个终端窗口、会话切换繁琐,难以自动化和规模化。
dmux-workflows Skill 的优势:
- 通过 tmux 多 pane(分屏)统一管理多个 Agent,会话隔离、切换高效。
- 支持一键新建 pane、任务拆分、结果合并,适配 Claude Code、Codex、OpenCode、Gemini、Qwen 等主流 Agent Harness。
- 可结合 git worktree 实现文件级隔离,避免合并冲突。
- 支持自动化脚本 orchestration,适合大规模多 Agent 流水线和团队协作。
- 适用场景涵盖:并行开发、跨角色协作、测试与修复循环、代码评审流水线、跨工具链开发等。
2. 何时激活 dmux-workflows Skill?
- 你需要并行运行多个 Agent 会话,如同时开发、测试、文档编写。
- 需要跨 Claude Code、Codex、OpenCode 等不同工具链分工协作。
- 任务复杂、可拆分为独立子任务,适合“分而治之”并行推进。
- 用户主动提出“run in parallel”、“split this work”、“use dmux”、“multi-agent”等需求。
- 希望自动化多 Agent 编排,如大规模代码审计、批量文档生成等。
3. 实战操作指南(Step by Step)
步骤 1:安装并启动 dmux
- 安装 tmux(如未安装):bash
# macOS brew install tmux # Ubuntu/Debian sudo apt install tmux - 安装 dmux(推荐先审查 官方仓库):bash
git clone https://github.com/standardagents/dmux.git cd dmux npm install -g . - 启动 dmux 会话:bash
dmux
步骤 2:分屏并分配任务
- 在 dmux 主界面,按
n新建一个 pane,输入该 pane 的 Agent prompt。 - 示例:
- Pane 1:
实现 src/auth/ 目录下的鉴权中间件 - Pane 2:
为 user service 编写单元测试 - Pane 3:
更新 API 文档
- Pane 1:
每个 pane 会自动启动独立的 Agent 会话,互不干扰。
步骤 3:并行推进任务
- 各 pane 独立运行,实时查看进度。
- 可随时切换 pane,查看/调整各自的输出。
步骤 4:合并结果
- 完成后,按
m键将某个 pane 的输出合并回主会话,便于整体集成和 review。 - 建议在合并前,先 review 各 pane 的输出,避免冲突或重复。
步骤 5(可选):结合 git worktree 进行文件隔离
- 对于可能涉及文件冲突的任务,建议为每个 pane 创建独立的 git worktree:bash
git worktree add -b feat/auth ../feature-auth HEAD git worktree add -b feat/billing ../feature-billing HEAD - 各 pane 进入对应 worktree 目录,运行 Agent:bash
# Pane 1 cd ../feature-auth && claude # Pane 2 cd ../feature-billing && claude - 合并时,先在主分支合并各 feature 分支,最大限度减少冲突。
步骤 6(进阶):自动化 orchestration
- ECC 提供了自动化脚本,支持基于 plan.json 一键 orchestrate 多 worktree、多 pane、多 Agent 的流水线:bash
node scripts/orchestrate-worktrees.js plan.json --execute - plan.json 示例:json
{ "sessionName": "skill-audit", "baseRef": "HEAD", "launcherCommand": "codex exec --cwd {worktree_path} --task-file {task_file}", "workers": [ { "name": "docs-a", "task": "Fix skills 1-4 and write handoff notes." }, { "name": "docs-b", "task": "Fix skills 5-8 and write handoff notes." } ] } - 支持自动创建 worktree、分发任务、生成 handoff/status 文件、启动 tmux 多 pane 并行执行。
4. 典型工作流模式与输出示例
模式一:调研 + 实现并行
bash
# Pane 1(调研): "调研 Node.js 限流最佳实践,输出到 /tmp/rate-limit-research.md"
# Pane 2(实现): "为 Express API 实现限流中间件,先用 token bucket,后续根据调研优化"
# 合并:调研完成后,将结果合并到实现 pane,持续迭代模式二:多文件特性开发
bash
# Pane 1: "为 billing 功能设计数据库 schema 和 migration"
# Pane 2: "开发 src/api/billing/ 下的 API endpoint"
# Pane 3: "实现 billing dashboard 的前端 UI 组件"
# 合并:全部完成后主 pane 集成测试模式三:测试 + 修复循环
bash
# Pane 1(Watcher): "watch 模式运行测试,失败时总结错误"
# Pane 2(Fixer): "根据 pane 1 的错误输出修复代码"模式四:跨 Agent 工具链协作
bash
# Pane 1 (Claude Code): "审查 auth 模块安全性"
# Pane 2 (Codex): "重构工具函数提升性能"
# Pane 3 (Claude Code): "为 checkout 流程编写 E2E 测试"模式五:并行代码评审
bash
# Pane 1: "审查 src/api/ 的安全漏洞"
# Pane 2: "审查 src/api/ 的性能问题"
# Pane 3: "审查 src/api/ 的测试覆盖率缺口"
# 合并:所有 review 结果整合成一份报告5. 最佳实践与注意事项
- 只并行独立任务:避免将有强依赖关系的任务分配到不同 pane,防止数据竞争和上下文错乱。
- 清晰划分边界:每个 pane 只负责独立文件/模块/关注点,减少冲突。
- 合并前仔细 review:先检查 pane 输出,必要时手动 resolve 冲突。
- 充分利用 git worktree:高风险任务建议每 pane 独立 worktree,主分支统一合并。
- 控制 pane 数量:每个 pane 都会消耗 API token,建议单次并行 5-6 个以内,避免 token 爆炸。
- 资源监控:大规模并行时注意本地/云端资源消耗,合理分配。
6. 常见配套 Agent 与 Skill 协作关系
- Claude Code Task Tool:在单个 session 内自动生成子 Agent 并行处理,可与 dmux-workflows 互补,适合小规模自动化。
- Superset:适合超大规模(10+)Agent 并行场景,如大批量代码审计或文档生成。
- Codex Multi-Agent:Codex 内置多角色并行机制,dmux-workflows 可统一调度。
- Agent Harness Construction Skill:与 dmux-workflows 配合设计多 Agent 的 action space,提升任务完成率。
- Verification Loop Skill:可将并行输出结果统一进入端到端验证循环,保障质量。
- Hooks 自动化体系:结合 PreToolUse/PostToolUse/Stop 事件,实现 pane 级自动化触发与集成。
FAQ
Q: dmux-workflows Skill 适合单人还是团队使用? A: 两者均适用。单人可高效拆分多任务,团队可通过 worktree+dmux 实现多人并行与自动化集成。
Q: 并行 pane 会不会导致文件冲突或上下文混乱? A: 推荐每 pane 独立文件或配合 git worktree 隔离,合并前统一 review,能有效避免冲突。
Q: 如何与自动化脚本、CI/CD 集成? A: ECC 提供 orchestration 脚本,可自动创建 worktree、分发任务、生成报告,适合大规模流水线和 CI/CD 集成。