findscripter 何时使用
当一个任务可以拆成互相独立、可分而治之的子任务，且并行推进比单线迭代更划算时，用 dmux 在 tmux 面板里同时跑多个 Agent 会话。典型场景：
- 同时跑多个 Agent 会话（每个面板一个独立 harness 实例）。
- 跨 Claude Code、Codex、OpenCode 等不同 harness 协调同一项目的工作。
- 复杂任务的分而治之并行（多文件功能、并行评审、测试+修复双轨）。
- 用户说「并行跑」「split this work」「用 dmux」「多 Agent」。
不该用的边界：
- 子任务彼此依赖对方输出——别把有先后依赖的步骤并行（会拿到半成品）。
- 需要 Agent 之间实时通信/协作——dmux 面板各自独立，靠人工
m合并单向汇总。 - 改动会相互冲突的全局重构——除非每个面板用独立 git worktree 隔离。
- 单会话内的编程式并行——那是 Claude Code Task 工具的活，不必起 dmux。
步骤
dmux 是基于 tmux 的 Agent 面板编排器。安装：npm install -g dmux（详见 github.com/standardagents/dmux）。支持 Claude Code、Codex、OpenCode、Cline、Gemini、Qwen。
- 启动：终端跑
dmux进入会话。 - 开面板派任务：按
n新建面板并输入该面板的 prompt（一个面板 = 一个独立 Agent 会话，负责一块边界清晰的工作）。 - 监控：各面板各自跑自己的 Agent；面板无响应时按
m读其输出，确认是否在等待输入。 - 合并产出：按
m把某面板结果合并回主会话上下文。合并前先 review 输出，避免引入冲突。 - （冲突高发时）worktree 隔离：对会触碰重叠文件的任务，先建 git worktree，每个面板在各自 worktree 里
claude，完成后回主分支git merge。
指令
核心快捷键（在 dmux 会话内）：
n—— 新建面板并附带 prompt，启动一个新 Agent 会话。m—— 把面板输出合并回主会话（也用于读取面板当前输出）。
git worktree 隔离（重叠文件并行的标准做法）：
# 为每条特性建独立 worktree
git worktree add ../feature-auth feat/auth
git worktree add ../feature-billing feat/billing
# 不同面板进各自 worktree 跑 Agent
# Pane 1: cd ../feature-auth && claude
# Pane 2: cd ../feature-billing && claude
# 完成后回主分支合并
git merge feat/auth
git merge feat/billing
最佳实践（硬约束）：
- 只并行独立任务——有依赖关系的不要并行。
- 边界清晰——每个面板只动各自的文件/关注点。
- 合并要克制——合并前 review 面板输出防冲突。
- 冲突用 worktree——文件易冲突的工作每面板一个 worktree。
- 资源意识——每个面板都是一个完整 Agent 会话、消耗 API token，总面板数控制在 5-6 以内。
互补工具选型：
| 工具 | 作用 | 何时用 |
|---|---|---|
| dmux | tmux 面板管理 Agent | 并行 Agent 会话 |
| Superset | 终端 IDE，10+ 并行 Agent | 大规模编排 |
| Claude Code Task 工具 | 进程内派生子 Agent | 单会话内编程式并行 |
| Codex 多 Agent | 内建 Agent 角色 | Codex 专属并行 |
示例
常用编排模式（每行一个面板的 prompt）：
模式 1 · 研究 + 实现（research/implement 双轨）
Pane 1 (Research): "调研 Node.js 限流最佳实践，对比现有库与方案，把结论写到 /tmp/rate-limit-research.md"
Pane 2 (Implement): "为 Express API 实现限流中间件，先做基础 token bucket，待研究完成再精修"
# Pane 1 完成后，把结论合并进 Pane 2 的上下文
模式 2 · 多文件功能（独立文件并行）
Pane 1: "为计费功能创建数据库 schema 与迁移"
Pane 2: "在 src/api/billing/ 实现计费 API 端点"
Pane 3: "创建计费仪表盘 UI 组件"
# 全部合并后，在主面板做集成
模式 3 · 测试 + 修复循环
Pane 1 (Watcher): "watch 模式跑测试套件，失败时汇总失败项"
Pane 2 (Fixer): "根据 Pane 1 的错误输出修复失败测试"
模式 4 · 跨 harness
Pane 1 (Claude Code): "评审 auth 模块的安全性"
Pane 2 (Codex): "为性能重构工具函数"
Pane 3 (Claude Code): "为结算流程写 E2E 测试"
模式 5 · 并行评审流水线（多视角）
Pane 1: "评审 src/api/ 的安全漏洞"
Pane 2: "评审 src/api/ 的性能问题"
Pane 3: "评审 src/api/ 的测试覆盖缺口"
# 三份评审合并为一份报告
注意事项
- 面板无响应：多半是 Agent 会话在等待输入，按
m读输出确认。 - 合并冲突：用 git worktree 把各面板的文件改动隔离开。
- token 高耗：减少并行面板数——每个面板都是一个完整 Agent 会话。
- tmux 未安装：macOS
brew install tmux，Linuxapt install tmux。 - dmux 是 tmux 之上的编排层，强依赖本机 tmux 环境，不适用于纯 Windows 原生终端（用 WSL/Linux/macOS）。
互见
- related：
parallel-agent-hub—— 同一任务上多 Agent 竞赛择优（worktree 隔离 + 指标/LLM 评审），比 dmux 的人工合并更自动化。 - related：
multi-agent-workflow-designer—— 先用它选编排模式（顺序/并行/路由/编排器/评估器）画蓝图，再用 dmux 落到面板执行。 - related：
multi-agent-system-designer、autonomous-coding-agent-patterns、agent-workflow-pattern-designer - combines_with：
git-worktrees-workflow—— 为高冲突并行任务提供分支/工作树隔离，是模式 2/全局重构的前提。 - combines_with：
crewai-multi-agent—— 需要进程内、有结构化角色与通信的多 Agent 系统时改用它（dmux 是面板级、无 Agent 间通信）。
采编自 affaan-m/everything-claude-code（MIT 许可），适配重写为中文版，非逐字翻译。