Paseo 并行开发是什么:一句话定义
Paseo 的并行开发指在一个界面里同时运行多个编码代理,每个 agent 在自己独立的 git worktree 里改代码,互不覆盖,可分布在一台或多台机器上,由内置编排、CLI 或 TypeScript SDK 驱动。Paseo 本身是 Apache-2.0 开源的 agentic development environment,GitHub star 约 2 万(2026-10 查询为 20,755),架构见上一篇介绍。它针对的痛点:多任务并行时,agent 之间的文件冲突和进度状态全靠人肉记账。
为什么并行 agent 必须先解决 worktree 问题
两个 agent 在同一个工作目录里干活,第一个小时就会互相踩:文件覆盖、git 混乱、测试污染。
拆开是三类冲突。文件层,A 重构到一半的模块被 B 整体改写,后续编辑直接落在 B 的版本上,双方都不知情。git 层,两个 agent 交替 stage 和 commit,半成品混进对方的提交,diff 无法归因。验证层,A 改坏代码导致测试挂掉,B 误以为是自己的问题,开始错误的修复。单人开发靠”别同时干两件事”回避冲突,但并行 agent 的意义就在于同时干。
git worktree 是 git 自带的解法:同一仓库检出多个工作目录,各有独立分支和工作区,物理上无法互相覆盖。剩下的工程问题是记账——worktree 多了之后,谁在哪个目录、跑到哪步、谁该合并,需要有人管。Paseo 的并行模型就是冲着记账去的。
Paseo 的并行模型:隔离是默认,编排是内置
规则很简单:同时跑多个 agent,每个在自己的 worktree 里,可分布在一台或多台机器上(README 口径)。隔离是默认行为,不需要先手动建好 worktree 再把 agent 指过去。
更进一层的是内置编排(built-in orchestration):agent 可以创建 worktree、启动其他 agent 并与之对话,跨 provider 生效。分量在编排权下放——编排逻辑从人或外部脚本手里移到 agent 自己手上:主 agent 发现任务能拆成三块,自己建 worktree、拉起两个子 agent、等结果、汇总结论,全程界面可见。跨 provider 则让”Claude 规划审查、Codex 批量实现”这类组合不需要胶水代码。
与外部脚本编排(bash 同时起多个 claude 进程)相比,状态集中在 daemon:会话、输出、worktree 归属都是结构化数据,一条 paseo ls 看清全局,手机端同样可见。
三个官方 Skill:把编排套路固化成命令
官方提供三个编排 skill,一条命令安装:
npx skills add getpaseo/paseo
这组 skill 教会 agent 用 Paseo 编排其他 agent,在对话里让主 agent 调度别的 agent,套路如下。
/paseo-handoff:跨 agent 交接。 作者自述的用法:先用 Claude 规划,再交给 Codex 实现。适用场景是模型分工——规划要强推理,实现要速度和低成本,handoff 把规划产物(方案、上下文、约束)传给实现者,实现者从干净上下文起步,不被试错污染。
/paseo-advisor:只出主意,不接活。 起一个独立 agent 当顾问,给方案第二意见,明确不委托工作本身。适用场景:方案评审与风险检查——实现 agent 容易”既是运动员又是裁判”,审自己的方案效果有限;独立顾问没有沉没成本,挑刺更客观。
/paseo-committee:对立双 agent 委员会。 组建两个立场对立的 agent,退一步做根因分析并产出计划。适用场景:debug 连续失败、方向僵持——单个 agent 容易沿自己的假设一路走到黑,对立委员会就是要逼出盲点,产出的计划再交回实现。
三个 skill 正好覆盖并行的三个阶段:拆活(handoff)、把关(advisor)、纠偏(committee)。
CLI 编排:六条命令覆盖日常
命令行是直接入口,以下命令出自官方 README:
# 用指定 provider 启动一个 agent
paseo run --provider claude/opus-4.6 "implement user authentication"
# 指定 worktree 启动,隔离到 feature-x
paseo run --provider codex/gpt-5.5 --worktree feature-x "implement feature X"
# 列出运行中的 agent
paseo ls
# 实时跟随某个 agent 的输出流
paseo attach abc123
# 给运行中的 agent 追加任务
paseo send abc123 "also add tests"
# 连远程 daemon 执行任务,--cwd 是那台机器上的路径
paseo run --host workstation.local:6767 --cwd /workspace "run the full test suite"
逐条看:run 是启动原语,--provider 选模型,--worktree 指定工作分支——第二条命令就是并行模型的最小示例,两个 agent 可以这样分别起在不同分支。ls 与 attach 管可观测性:前者全局视图,后者单 agent 实时输出流。send 管”中途想起还有一件事”:追加指令不重启会话,上下文连续。最后一条是跨机器编排:--host 指向另一台机器的 daemon,--cwd 是那台机器上的路径,本地只发指令。
TypeScript SDK:把 agent 编排接进你自己的系统
在程序里驱动 agent 用官方 TypeScript SDK(npm 包 @getpaseo/client),README 示例如下:
const client = createPaseoClient({ url: "ws://127.0.0.1:6767/ws" });
await client.connect();
const agent = await client.agents.create({
config: { provider: "codex/gpt-5.5" },
cwd,
prompt: "Review the current diff and name the riskiest change.",
});
const result = await agent.waitForFinish();
console.log(result.lastMessage);
await client.close();
逐行看:createPaseoClient 建 WebSocket 连接,ws://127.0.0.1:6767/ws 指向本地 daemon(6767 也是 Docker 镜像默认暴露的端口,docs/docker.md)。client.agents.create 创建 agent:config.provider 指定模型,cwd 指定工作目录,prompt 是任务。waitForFinish 等到跑完,result.lastMessage 取最后一条消息,close 释放连接。
README 给的三个用途:issue 集成、仪表盘、编排服务。落到工程场景:issue 机器人(issue 打标签自动触发 agent 修复并回评)、团队仪表盘(运行中 agent 状态板)、批量任务(清单逐条喂给 agents.create)。SDK 与 CLI 连同一个 daemon,CLI 给人用,SDK 给程序用。
并行任务的标准收尾流程
README 的 parallel tasks 文档给出一条示例流程,四步:
- review diff——审 agent 的改动
- 跑应用——把改动在本地跑起来
- 内置浏览器验证——直接看效果,不切出去开 localhost
- 开 Pull Request——不出窗口完成提交
标注:这是文档的示例流程,可按项目增删环节,但顺序值得保留——先归因 diff,再运行验证,最后开 PR。多 agent 并行时对每个 worktree 各走一遍。
和手动 git worktree 工作流比,省的是什么
同一套”多 worktree 并行”方法论,手动维护和交给 Paseo 的差别在记账成本:
| 环节 | 手动 worktree + 多终端 | Paseo |
|---|---|---|
| 建 worktree | 手动 git worktree add | agent 可自建,或 --worktree 启动时指定 |
| 监控进度 | 终端窗口切来切去 | 一个窗口加 paseo ls,手机可查 |
| 追加指令 | 找到对应终端重新输入 | paseo send 按会话追加 |
| 输出留存 | 关终端即丢 | daemon 持有会话状态 |
| 跨机器 | 自己拼 ssh | --host 直连远程 daemon |
结论定性:Paseo 省的是上下文切换和状态追踪的人力,worktree 隔离两者都有。已手动用 worktree 且并行量不大的,git worktree GUI 工具那篇里的可视化管理也够用;agent 数量上去后,界面和编排的收益才拉开。
常见问题
Claude Code 能并行跑多个任务吗?
能。手动路线:每个任务建一个 git worktree、开多个终端各跑一个 Claude Code;编排路线:用 Paseo 这类环境,每个 agent 自动各占一个 worktree,一个窗口监控全部。
手动路线免费但要自己记账:哪个 worktree 对应哪个任务、谁先合并、冲突怎么解,全靠人盯。Paseo 把 worktree 分配、会话状态、追加指令(paseo send)产品化,还支持跨机器和跨 provider,量大后差距明显。
git worktree 怎么做并行开发?
用 git worktree add 为每个任务检出独立目录和分支,物理隔离互不覆盖,干完各自合并回主干。
它解决”多份工作同时推进”的文件互踩问题:同一仓库多个工作区,各自在不同分支,提交互不干扰。手动管理的痛点在状态记账,worktree 一多就需要 GUI 或编排工具接手。
Paseo 有没有上手教程?
有。前置要求是装好至少一个 agent CLI 并配好凭据;桌面端从 paseo.sh/download 下载、打开自动启动 daemon,CLI 编排从 paseo run 一条命令起步。
建议顺序:先跑通单 agent,再试 --worktree 双 agent 并行,最后上 SDK 做程序化编排。安装部署完整步骤(npm 部署、Docker、手机配对)见站内Paseo 安装教程;同类工具取舍可看Paseo 与 Omnigent 对比。