Skip to content

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

  1. 安装 tmux(如未安装):
    bash
    # macOS
    brew install tmux
    # Ubuntu/Debian
    sudo apt install tmux
  2. 安装 dmux(推荐先审查 官方仓库):
    bash
    git clone https://github.com/standardagents/dmux.git
    cd dmux
    npm install -g .
  3. 启动 dmux 会话:
    bash
    dmux

步骤 2:分屏并分配任务

  • 在 dmux 主界面,按 n 新建一个 pane,输入该 pane 的 Agent prompt。
  • 示例:
    • Pane 1: 实现 src/auth/ 目录下的鉴权中间件
    • Pane 2: 为 user service 编写单元测试
    • Pane 3: 更新 API 文档

每个 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. 最佳实践与注意事项

  1. 只并行独立任务:避免将有强依赖关系的任务分配到不同 pane,防止数据竞争和上下文错乱。
  2. 清晰划分边界:每个 pane 只负责独立文件/模块/关注点,减少冲突。
  3. 合并前仔细 review:先检查 pane 输出,必要时手动 resolve 冲突。
  4. 充分利用 git worktree:高风险任务建议每 pane 独立 worktree,主分支统一合并。
  5. 控制 pane 数量:每个 pane 都会消耗 API token,建议单次并行 5-6 个以内,避免 token 爆炸。
  6. 资源监控:大规模并行时注意本地/云端资源消耗,合理分配。

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 集成。