Pi 子代理选型：会话、并行任务与 Worktree

概览

Pi 默认提供 read、write、edit、bash 四个工具。子代理编排通过扩展补充，由扩展调度子会话并将结果交回父会话。

选型时分别判断：子任务在哪个进程执行、继承哪些上下文、修改哪份文件。独立会话不会自动拥有独立工作目录。

先区分执行方式

当前 pi-subagents 的前台子任务在父进程中执行 SDK 会话，后台任务使用独立 runner。@tintinweb/pi-subagents 的普通前台和后台任务都在宿主进程中运行 SDK 会话，脚本工作流解释器另用 worker 线程。

两个包目前都支持可选 worktree。更有用的区别是生命周期与交接：Nico 的托管工作流 worktree 记录补丁及交接清单；Tintin 将完成后的修改保存在本地分支。子任务完成都不等于修改已合并。

按任务选择

并行阅读或独立审查可共用工作目录，避免 worktree 创建开销，也能看见未提交 diff。多个代理同时写代码时，应分配互不重叠的文件，或明确要求 worktree。

需要 Agent/get_subagent_result、实时组件和可中途引导的后台代理时可选 Tintin；需要 worker/reviewer 角色、链式任务、脚本工作流与独立后台产物时可选 Nico。依赖界面行为前，应在自己的 TUI 或 SDK 宿主中验证已安装版本。

Token 成本与上下文隔离

估算总用量时，要相加父会话输入输出、每个子任务的输入输出及结果汇总。N 个并行子任务可能支付 N 份相同上下文。进程或 worktree 隔离本身不会降低 Token 单价。

探查任务尽量提供明确问题和少量上下文，只有确实需要历史讨论时才分叉对话。限制工具、选择合适模型并设并发上限。用同一任务比较子代理报告的 Token 与缓存用量；本指南未做跨包 Token 基准测试。

验证第一次委派

安装选中的一个包后重启 Pi，先委派只读的仓库清点任务。确认父会话收到结果、子代理使用预期模型，并检查工作区没有变化。

下面的 Tintin Agent 调用要求后台阅读，不创建 worktree。可打开 /agents 检查子会话；确实需要独立的已提交工作区时，再添加 isolation: "worktree"。

Agent({
  subagent_type: "Explore",
  prompt: "List the test commands and their source files. Do not edit files.",
  description: "Find test commands",
  run_in_background: true
})