跳转到主要内容

​
两种方式

Trellis 支持两种方式运行多个 agent： 本指南介绍 Multi-Session —— 基于 worktree 的方式。

​
为什么用 Multi-Session

有些任务是独立的。加登录页面不影响加设置页面。用独立的 worktree，agent 之间互不干扰。
每个 worktree 是独立的 checkout，在独立的分支上。开发过程中不会有合并冲突。 完成后，每个会话创建一个 PR。你审查然后合并。

​
配置

启动前，在项目根目录创建 worktree.yaml：
每个任务定义：
  • id：唯一标识符
  • branch：Git 分支名
  • prd：此任务的需求

​
启动并行会话

在 Claude Code 里用 /trellis:parallel 命令。它会引导你：
  • 定义任务
  • 创建 worktree
  • 启动会话
这会创建：
  • 每个任务一个 worktree
  • 每个任务一个 Claude Code 会话
  • 每个任务一个分支
每个会话独立运行。

​
监控进度

查看状态：
输出会显示每个任务的当前阶段和分支。

​
会话流水线

每个会话经过这些阶段：
  1. Plan - 理解需求，找出要改的文件
  2. Implement - 写代码
  3. Check - 按规范审查，自己修问题
  4. PR - 创建 pull request
check 阶段有个 “Ralph Loop”——如果发现问题，它会回去修。这防止提交质量差的 PR。

​
什么时候用

适合：
  • 独立的功能
  • 并行修 bug
  • 生成变体（同一问题的不同方案）
不适合：
  • 互相依赖的功能
  • 改同一个文件的工作
  • 需要跟 AI 反复迭代时

​
清理

完成后清理 worktree：
这会删除 worktree 但保留分支。合并后的分支正常删就行。

​
平台支持

Multi-Session 需要 hooks 来自动注入上下文（目前 Claude Code 和 iFlow 支持）。

​
Agent 流水线

每个 Multi-Session 任务使用 6-agent 流水线： 你也需要足够的 API 额度。三个会话意味着三倍的 token 消耗。