你是否曾希望 Pi 不只是一个“单打独斗”的 AI 助手，而是能同时派出几位各司其职的“专家同事”——比如一位专盯代码逻辑、一位专查测试覆盖、一位负责提问澄清、另一位默默在后台做深度审计？pi-subagents 正是为此而生：它不是替代 Pi，而是为 Pi 赋予“分身术”与“项目管理力”，把复杂任务自动拆解、分派、协同、汇总，真正实现“一个大脑，多双眼睛，分工不扯皮”。
核心功能
- 自然语言一键委派：无需写配置、不用记命令，直接说“请 reviewer 检查这段 diff”或“让 scout 帮我理解这个模块”，Pi 自动启动对应子代理并返回结果
- 多角色子代理协同：预置 reviewer（代码审查）、scout（上下文理解与提问）、oracle（交叉验证决策）、implementer（方案落地）等角色，支持自定义扩展
- 并行执行与结果聚合：可同时启动多个子代理处理同一任务的不同维度（如“分别检查安全性、性能、可维护性”），结果自动归并呈现
- 会话上下文共享：所有子代理继承父会话的完整对话历史、文件上下文和目标意图，避免重复解释，保障理解一致性
- 前台流式响应 + 后台异步执行：关键任务即时反馈；耗时分析（如全量代码扫描）可转为后台作业，完成后主动通知，不阻塞主流程
- 结果截断与产物管理：自动处理长输出（避免 token 溢出），并结构化保存中间产物（如生成的测试用例、问题清单、重构建议），随时回溯
适合哪些人用
这款工具特别适合每日与代码深度打交道的技术实践者：前端/后端工程师在 Code Review 时需要多视角交叉验证；全栈开发者在重构复杂模块前希望先获得架构级洞察；技术负责人想快速评估 PR 的质量风险而不逐行细读；AI 辅助编程重度用户，厌倦了反复粘贴上下文、手动切窗口、拼凑碎片结论——只要你希望 AI 协作更像“带一支小队”，而不是“只雇一个实习生”，pi-subagents 就是那个提效杠杆。
快速上手
安装极其简单：
在 Pi 客户端中执行一行命令即可：
pi install npm:pi-subagents
安装完成后，无需重启、无需配置，立刻可用！推荐从这些日常场景开始尝试：
- “用 reviewer 看看这个 Git diff 有没有边界条件遗漏？”
- “请 scout 通读我刚贴的 React 组件，然后问我 3 个关键问题”
- “启动两个 reviewer：一个专注错误处理，一个专注状态更新逻辑”
- “让 oracle 对比我刚才提出的两种设计思路，指出各自隐含风险”
所有指令都用中文自然表达，Pi 会自动识别意图、调度子代理、整合反馈——就像给你的 AI 助手配上了智能项目经理。
项目信息
Pi extension for async subagent delegation with truncation, artifacts, and session sharing
编程语言：TypeScript｜GitHub Star 数：1919｜开源协议：未明确声明（建议使用前查阅仓库 LICENSE 文件）｜GitHub 项目地址
这是目前 Pi 生态中最成熟、最易用的子代理调度框架，已稳定支撑数千开发者的日常协作流。
