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 文档给出一条示例流程,四步:

  1. review diff——审 agent 的改动
  2. 跑应用——把改动在本地跑起来
  3. 内置浏览器验证——直接看效果,不切出去开 localhost
  4. 开 Pull Request——不出窗口完成提交

标注:这是文档的示例流程,可按项目增删环节,但顺序值得保留——先归因 diff,再运行验证,最后开 PR。多 agent 并行时对每个 worktree 各走一遍。

和手动 git worktree 工作流比,省的是什么

同一套”多 worktree 并行”方法论,手动维护和交给 Paseo 的差别在记账成本:

环节手动 worktree + 多终端Paseo
建 worktree手动 git worktree addagent 可自建,或 --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 对比。