如何用 workmux 并行跑 N 个 AI Agent多工作树批量生成 提示词模板完全教程【免费下载链接】workmuxgit worktrees tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmux想用workmux同时驱动 N 个 AI Agent 并行干活这篇教程给你讲透它的核心玩法一条命令批量生成多个 git 工作树worktree配合**提示词模板Prompt 模板**把同一个任务按变量展开成 N 份让 claude、gemini、codex 等多个 AI 编程助手在各自隔离的 tmux 窗口里同时工作互不冲突最后还能一键合并清理。无论你是新手还是老玩家照着做 10 分钟就能跑起来。为什么 workmux 适合多 Agent 并行 手动开 N 个终端、N 个分支、N 个 Agent切换上下文、stash、合并冲突……想想就头大。workmux 的思路是一个任务 一个 git 工作树 一个 tmux 窗口 一个 AI Agent。每个 Agent 有独立目录和终端状态改代码互不干扰自动复制.env、软链node_modules新工作树开箱即用一条workmux merge完成合并 删工作树 关窗口 删分支的全套清理整体工作流如下图所示左侧侧边栏实时显示每个工作树的 Agent 状态中间是正在运行的 AI Agent右侧是编辑器一键安装与初始化步骤workmux 要求先装好 tmux也支持 kitty / WezTerm / Zellij 作为后端。安装方式任选其一# HomebrewmacOS/Linux brew install raine/workmux/workmux # 或 Cargo cargo install workmux在项目里初始化一份项目级配置可选默认值开箱即用workmux init # 生成 .workmux.yaml最实用的最小配置让每个新窗口的第一个面板直接启动 Agent# .workmux.yaml agent: claude panes: - command: agent focus: true - split: horizontal # 第二个面板留给 shellagent是占位符会被配置里的agent值或--agent参数替换。完整选项见 docs/src/content/docs/guide/configuration.md。基础热身创建第一个 Agent 工作树# 创建 worktree tmux 窗口并自动切过去 workmux add user-auth -p 用 OAuth 实现用户登录这一条命令会创建 git 工作树 → 复制配置/软链依赖 → 打开 tmux 窗口 → 把提示词自动注入 Agent 面板 → 切到新窗口。Agent 收到提示词后直接开干你什么都不用敲。核心玩法 1一条命令生成 N 个 Agent 工作树 这是 workmux 最亮的功能——四种互斥的批量生成模式详细参数见 docs/src/content/docs/reference/commands/add.mdx模式 A每个 Agent 一个工作树多模型对比重复使用-a/--agent每个指定 Agent 各生成一个工作树适合让不同模型赛马workmux add my-feature -a claude -a gemini -a codex \ -p 实现新的搜索 API 集成 # 生成my-feature-claude、my-feature-gemini、my-feature-codex模式 B同 Agent 跑 N 份实例用-n/--count复制同一 Agent N 份提示词里用{{ num }}区分任务号workmux add my-feature -n 2 -p 实现 TASKS.md 中的任务 #{{ num }} # 生成my-feature-1、my-feature-2模式 C变量矩阵 --foreach按变量:值1,值2声明矩阵各变量的值按下标配对zip 而非笛卡尔积每个组合一个工作树workmux add my-feature --foreach platform:iOS,Android \ -p 为 {{ platform }} 构建目标平台支持 # 生成my-feature-ios、my-feature-android模式 Dstdin 管道批量输入把外部命令的输出逐行喂给workmux add每行变成一个工作树行内容就是模板变量{{ input }}# review.md 里写着审查 {{ input }} 模块的安全问题 echo -e auth\npayments\napi | workmux add review -A -P review.md还支持 JSON Lines每行的每个键都会变成模板变量非常适合接jq处理的数据。批量生成后所有窗口并行开工tmux 侧边栏一览无余——每个工作树的 Agent 在忙什么、改了多少代码、处于什么状态一眼看清核心玩法 2提示词模板完全指南 批量模式下的提示词会被当作Jinja2 风格模板处理可用变量变量含义{{ base_name }}你传入的工作树基础名{{ agent }}当前 Agent 名{{ num }}/{{ index }}实例编号 / 行号{{ input }}stdin 管道输入的当前行任意--foreach变量如{{ platform }}⚠️ 注意单工作树的add不套模板原样传递所以提示词里写 GitHub Actions 的${{ ... }}之类语法不用转义。提示词文件 YAML frontmatter推荐把矩阵写进提示词文件头部比命令行参数更整洁变量和用法近在咫尺--- foreach: platform: [iOS, Android] lang: [swift, kotlin] --- 用 {{ lang }} 构建 {{ platform }} 应用实现用户认证与数据持久化。 完成后运行: workmux remove --keep-branchworkmux add mobile-app --prompt-file mobile-task.md # 生成mobile-app-ios-swift、mobile-app-android-kotlin分支名模板 --branch-template批量模式下分支名由模板生成默认已包含 agent/num 等后缀可自定义workmux add add-tests --branch-template {{ base_name }}-{{ index }} \ --prompt-file generate-tests.md进阶限制并发的 worker 池 同时跑 20 个 Agent 容易触发模型 API 限流。--max-concurrent让你只放 N 个在跑某个窗口关闭后才启动下一个——前提是提示词里教 Agent 完成后自己清理如上文模板末尾的workmux remove --keep-branch# 官方推荐的批量生成测试脚手架配方 find src/utils -name *.ts ! -name *.test.ts | \ workmux add add-tests \ --branch-template {{ base_name }}-{{ index }} \ --prompt-file generate-tests.md \ --max-concurrent 3 \ --background--background让窗口在后台创建不抢焦点配合-W/--wait还能在脚本里阻塞等待 Agent 收尾实现串行任务编排。如何盯住 N 个 AgentDashboard 与 Sidebarworkmux dashboardTUI 面板列出所有工作树的 Agent、Git 状态、运行时长支持预览 diff、直接给 Agent 发指令是全览式监控台workmux sidebar在 tmux 里挂一个常驻侧边栏所有 Agent 的 busy / 待输入 / 完成状态一目了然状态图标默认显示 工作中/ 等你输入/ ✅完成Agent 卡住 10 秒无输出还会自动标记为中断方便及时介入。详见 docs/src/content/docs/guide/status-tracking.mdx。收尾一键合并与清理每个工作树完工后在对应窗口里执行workmux merge # 合并进主分支 删工作树 关窗口 删分支一步到位 workmux rm --all # 或批量清理未合并的实验性工作树如果走 PR 流程合并后workmux rm --gone会清掉远程分支已被删除的工作树。提示词模板设计清单 ✅写好提示词模板决定批量生成的成败任务自包含工作树之间不共享对话所有必要上下文写进模板本身结尾交代善后加上完成后运行workmux remove --keep-branch配合--max-concurrent形成自动流水用相对路径每个工作树有独立根目录引用文件用相对路径变量只用于差异点{{ input }}、{{ platform }}等变量聚焦这次和上次的不同公共规则保持固定分支名要短默认模板已按 slug 处理长变量名会拖长目录名延伸把工作树编排交给 Agent 自己workmux 自带/worktree技能你在主会话说把这些任务拆成子任务并行做它会自动写提示词文件并逐条执行workmux add把主 Agent 变成调度器。相关实现见 skills/worktree/SKILL.md 与 skills/coordinator/SKILL.md技能用法总览见 docs/src/content/docs/guide/skills.md。其他常用命令速查workmux docs可查看完整文档命令用途workmux list列出所有工作树及状态workmux open name为已有工作树重开窗口workmux rebase [name]把工作树分支变基到基线workmux path name获取工作树文件路径workmux reap-agents清理超时的 Agent 进程小结用 workmux 并行跑 N 个 AI Agent 的精髓就是三步workmux add批量生成隔离工作树 → 提示词模板按变量展开任务 →workmux merge一键收割。工作流细节可在 README.md 与 docs/src/content/docs/guide/agents.md 中继续深挖。现在就把你的第一个任务扔给 3 个 Agent让它们替你加班吧 【免费下载链接】workmuxgit worktrees tmux windows for zero-friction parallel dev项目地址: https://gitcode.com/gh_mirrors/wo/workmux创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考