pi-subagents：让 Pi 拥有”分身术”，把任务委派给异步子智能体
你是否曾经遇到这样的困境：一个 AI 会话既要读懂整个代码库、又要做代码审查、还要并行跑三套不同维度的检查，结果上下文爆炸、注意力涣散、关键细节被淹没？pi-subagents 的出现，旨在彻底解决这个问题。它是一个用 TypeScript 编写的 Pi 扩展，可以让主会话（父会话）把工作委派给专注的子智能体（child agents），每个子智能体只背负一件事——代码侦察、实现、审查、研究或者给出第二意见，并且支持后台异步执行、结果截断、工件留存与会话共享。本文将带你全面了解这个潜力新星。
截至收录：
pi-subagents stars数：3620
pi-subagents forks数：702
pi-subagents项目目录截图
pi-subagents核心亮点
🌟 亮点一：前后台双模式，异步委派不掉线：前台子智能体作为会话运行在父 Pi 进程内，进度直接流式输出在对话里；后台子智能体则运行在一个独立的（detached）runner 进程中，主控制权归还给你之后它依然继续工作，随时可以回头查看结果。装完包就能用，不会自动在后台乱跑一个”审查器”。
🎯 亮点二：七个内置智能体，零配置即用：你不需要创建 agent、写配置文件、背斜杠命令。安装后直接用自然语言说话即可，Pi 会自己决定要不要调用子智能体、用哪一个、怎么组合任务。
| 智能体 | 适用场景 |
|---|---|
scout |
快速本地代码库侦察：相关文件、入口点、数据流、风险点 |
researcher |
网络/文档研究，带来源与简明研究简报 |
evidence-auditor |
独立核验重要研究结论是否真的被来源支撑 |
worker |
实现类工作：改文件、做验证，遇到未获批的决策会升级上报而非瞎猜 |
reviewer |
针对任务/计划的代码审查与小型修复，关注测试、边界情况与简洁性 |
oracle |
行动前的第二意见，只挑战假设，不动手改代码 |
delegate |
行为最接近父会话的轻量通用委派者 |
🔒 亮点三：证据审计与验收门，拒绝”幻觉式自信”：evidence-auditor 会独立检查关键研究结论与其来源是否匹配，配合验收门（acceptance gates）机制，让”看起来很有道理”的回答先过一道事实关卡。对于依赖外部事实的决策，这一步价值极高。
🧩 亮点四：可编排、可脚本化、可规模化：包内自带 /council 与 council-mode，并提供了可自行放入 agent 目录的 council-* 模型配置示例；/parallel-review、/review-loop 等提示词快捷方式让并行审查、多轮审查循环变得可重复。maxSubagentSpawnsPerRun 限制单次运行树中逻辑子智能体的累计数量，默认 64，与”活跃并发数”和”会话级累计预算”相互独立，适合做有边界的编排。
📊 亮点五：可观测性拉满，看得见每一份在跑的工作：TUI 中，编辑器下方有一个常驻的 FleetView 展示活跃工作；/subagents-fleet 打开实时检查器，可以浏览子智能体、阅读完整对话记录、对正在运行的子智能体进行”转向”（steer）或直接终止。生命周期工件、事件、日志与会话共享一应俱全。
pi-subagents快速开始
只需几步，你就能在本地跑起 pi-subagents：
- 安装：
$ pi install npm:pi-subagents
这就是唯一必需的步骤。后台子智能体复用宿主机的 SDK：npm 版 Pi 会保留其独立的 Node runner；官方 Pi 0.85.1 Linux x64 独立发行版则通过 Pi 内置的 SDK 加载同一个 runner，无需单独安装 SDK。
- 用自然语言发出你的第一个委派：
Use reviewer to review this diff.
Ask oracle for a second opinion on my current plan. Challenge assumptions and tell me what I might be missing.
Use scout to understand this code based on our discussion, then ask me clarification questions.
Run parallel reviewers: one for correctness, one for tests, and one for unnecessary complexity.
- 看看有哪些子智能体可用、有哪些在跑：
Show me the available subagents.
Show active async runs.
常用工作流速查：
| 想要什么 | 就这样说 |
|---|---|
| 拿到第二意见 | “Ask oracle to review this plan and challenge assumptions.” |
| 啃硬骨头问题 | “Use oracle to investigate this bug before we edit.” |
| 审查一个 diff | “Use reviewer to review this diff.” |
| 并行审查 | “Run reviewers for correctness, tests, and cleanup.” |
| 辩一辩重大决策 | “Use /council with model-based advisors to compare this decision.” |
| 先实现再审查 | “Implement this, then review it.” |
| 审查到干净为止 | “Run a review loop on this change with a max of 3 rounds.” |
| 老老实实执行计划 | “Have worker implement this approved plan, then run reviewers and apply the feedback.” |
| 规划前先侦察 | “Use scout to inspect the auth flow before planning.” |
| 丢到后台跑 | “Run this in the background.” |
| 跑一套保存好的工作流 | “Run the review chain on this branch.” |
需要提醒的是：安装扩展并不会自动在后台启动一个审查器，它只是给了 Pi 一个委派工具。如果你希望每次实现都被审查，请在自己的提示词或项目指令里写清楚，例如：
When you finish implementing, run a reviewer subagent before summarizing.
对于实现类工作，推荐的循环是：澄清 → 侦察 → 实现 → 全新审查者 → 再实现。
pi-subagents应用场景
场景一：代码审查与质量门禁：开发者可以让 reviewer 针对某个 diff 做审查，关注任务/计划匹配度、测试覆盖、边界情况与不必要的复杂度；也可以让 worker 先实现已批准的计划，再交给”全新的”审查者复核并回灌反馈，形成可重复的审查闭环。
场景二：并行多维审计：一次发起多个审查者，分别盯正确性、测试、可清理的冗余代码，互不干扰。配合 worktree 隔离，多个子智能体可以在各自的代码副本上工作，避免互相踩脚。
场景三：后台长任务与批量作业：把耗时的工作（例如大规模代码库侦察、批量研究）丢到后台运行，控制权立刻回到你手上，稍后用 /subagents-fleet 或直接提问查看进度、读取转录、必要时干预或终止。
场景四：研究与事实核验：researcher 负责带来源的网络/文档研究并产出简明简报，evidence-auditor 再独立核验关键结论是否被来源支撑。两者都需要子智能体中具备 pi-web-access 能力。
场景五：高风险决策的第二意见：在做重大技术决策前，用 oracle 挑战你的假设，或者用 /council 让多个基于不同模型的顾问就同一决策进行对比辩论，把”我可能忽略了什么”提前暴露出来。
使用小贴士：如果你觉得哪里不对劲，运行 /subagents-doctor，或者直接问 “Check whether subagents and intercom are set up correctly.”。需要查阅已安装版本的帮助，可用 /subagents-guide [topic] 或 subagent({ action: "guide", topic: "workflows" })；可用主题包括 overview、workflows、agents、missions、observability、tool-reference、configuration、models、watchdog、extension-api。
完整文档位于项目的 docs/ 目录下，涵盖 Agents（自定义智能体、frontmatter 参考、覆盖内置智能体、工具、扩展、技能、按智能体记忆）、Models（单模型选择与启动、默认值、按角色覆盖、推荐分层、思考等级、模型范围强制、profiles）、Workflows（编排模式、提示词快捷方式、脚本化工作流、worktree 隔离、子父协作、递归保护）、Watchdog（可选的对抗式变更审查器、范围监控、LSP 检查、子智能体工具权限）、Tool reference（每一个 subagent 参数、管理动作、状态/控制动作、验收门、外部 CLI runner）、Observability（FleetView、fleet 检查器、生命周期工件、事件、日志、会话共享）、Missions and schedules（持久化任务记录、投递回执、定时与循环运行）、Configuration（每个 config.json 键与环境变量）、Extension API（RPC、委派 API、preflight、能力上限、受信工作流资源、后台工作提供方、Herdr 集成）。
pi-subagents链接
nicobailon / pi-subagents项目地址：https://github.com/nicobailon/pi-subagents
本文地址：https://www.tgoos.com/46443
