| name | dmux-workflows |
| description | 使用dmux（AI代理的tmux窗格管理器）进行多代理编排。跨OpenAI Codex、Codex、OpenCode及其他工具的并行代理工作流模式。适用于并行运行多个代理会话或协调多代理开发工作流时。 |
| origin | ecc |
dmux 工作流
使用 dmux（一个用于代理套件的 tmux 窗格管理器）来编排并行的 AI 代理会话。
何时激活
- 并行运行多个代理会话时
- 跨 OpenAI Codex、Codex 和其他套件协调工作时
- 需要分而治之并行处理的复杂任务
- 用户提到“并行运行”、“拆分此工作”、“使用 dmux”或“多代理”时
什么是 dmux
dmux 是一个基于 tmux 的编排工具，用于管理 AI 代理窗格：
- 按
n 创建一个带有提示的新窗格
- 按
m 将窗格输出合并回主会话
- 支持：OpenAI Codex、Codex、OpenCode、Cline、Gemini、Qwen
安装： npm install -g dmux 或参见 github.com/standardagents/dmux
快速开始
dmux
工作流模式
模式 1：研究 + 实现
将研究和实现拆分为并行轨道：
Pane 1 (Research): "研究 Node.js 中速率限制的最佳实践。
检查当前可用的库，比较不同方法，并将研究结果写入
/tmp/rate-limit-research.md"
Pane 2 (Implement): "为我们的 Express API 实现速率限制中间件。
先从基本的令牌桶算法开始，研究完成后我们将进一步优化。"
# Pane 1 完成后，将研究结果合并到 Pane 2 的上下文中
模式 2：多文件功能
在独立文件间并行工作：
Pane 1: "创建计费功能的数据库模式和迁移"
Pane 2: "在 src/api/billing/ 中构建计费 API 端点"
Pane 3: "创建计费仪表板 UI 组件"
# 合并所有内容，然后在主面板中进行集成
模式 3：测试 + 修复循环
在一个窗格中运行测试，在另一个窗格中修复：
窗格 1（观察者）：“在监视模式下运行测试套件。当测试失败时，
总结失败原因。”
窗格 2（修复者）：“根据窗格 1 的错误输出修复失败的测试”
模式 4：跨套件
为不同任务使用不同的 AI 工具：
Pane 1 (OpenAI Codex): "Review the security of the auth module"
Pane 2 (Codex): "Refactor the utility functions for performance"
Pane 3 (OpenAI Codex): "Write E2E tests for the checkout flow"
模式 5：代码审查流水线
并行审查视角：
Pane 1: "审查 src/api/ 中的安全漏洞"
Pane 2: "审查 src/api/ 中的性能问题"
Pane 3: "审查 src/api/ 中的测试覆盖缺口"
# 将所有审查合并为一份报告
最佳实践
- 仅限独立任务。 不要并行化相互依赖输出的任务。
- 明确边界。 每个窗格应处理不同的文件或关注点。
- 策略性合并。 合并前审查窗格输出以避免冲突。
- 使用 git worktree。 对于容易产生文件冲突的工作，为每个窗格使用单独的工作树。
- 资源意识。 每个窗格都消耗 API 令牌 —— 将总窗格数控制在 5-6 个以下。
Git Worktree 集成
对于涉及重叠文件的任务：
git worktree add -b feat/auth ../feature-auth HEAD
git worktree add -b feat/billing ../feature-billing HEAD
git merge feat/auth
git merge feat/billing
互补工具
| 工具 | 功能 | 使用时机 |
|---|
| dmux | 用于代理的 tmux 窗格管理 | 并行代理会话 |
| Superset | 用于 10+ 并行代理的终端 IDE | 大规模编排 |
| OpenAI Codex Task 工具 | 进程内子代理生成 | 会话内的程序化并行 |
| Codex 多代理 | 内置代理角色 | Codex 特定的并行工作 |
ecc 助手
ecc 现在包含一个助手，用于使用独立的 git worktree 进行外部 tmux 窗格编排：
node scripts/orchestrate-worktrees.js plan.json --execute
示例 plan.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." }
]
}
该助手：
- 为每个工作器创建一个基于分支的 git worktree
- 可选择将主检出中的选定
seedPaths 覆盖到每个工作器的工作树中
- 在
.orchestration/<session>/ 下写入每个工作器的 task.md、handoff.md 和 status.md 文件
- 启动一个 tmux 会话，每个工作器一个窗格
- 在每个窗格中启动相应的工作器命令
- 为主协调器保留主窗格空闲
当工作器需要访问尚未纳入 HEAD 的脏文件或未跟踪的本地文件（例如本地编排脚本、草案计划或文档）时，使用 seedPaths：
{
"sessionName": "workflow-e2e",
"seedPaths": [
"scripts/orchestrate-worktrees.js",
"scripts/lib/tmux-worktree-orchestrator.js",
".codex/plan/workflow-e2e-test.json"
],
"launcherCommand": "bash {repo_root}/scripts/orchestrate-codex-worker.sh {task_file} {handoff_file} {status_file}",
"workers": [
{ "name": "seed-check", "task": "Verify seeded files are present before starting work." }
]
}
故障排除
- 窗格无响应： 直接切换到该窗格或使用
tmux capture-pane -pt <session>:0.<pane-index> 检查它。
- 合并冲突： 使用 git worktree 隔离每个窗格的文件更改。
- 令牌使用量高： 减少并行窗格数量。每个窗格都是一个完整的代理会话。
- 未找到 tmux： 使用
brew install tmux (macOS) 或 apt install tmux (Linux) 安装。
