Pi 子代理
在 Pi 中委派并追踪专注的子代理任务，让审查、侦察和后台工作各自推进。
- Star 数
- ★ 4k
- 最近更新
- 1 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 77/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 开发者想在提交代码前让 reviewer 检查 diff、测试和边界情况。
- 不适合
- 不使用 Pi、需要独立运行子代理的团队
- 源码审查
- 77/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
pi-subagents 是一个 Pi 扩展，让主会话把任务交给职责明确的子 Pi 会话。子代理可用于代码审查、代码库侦察、实现、并行审计、保存的工作流和后台任务。前台子代理作为主 Pi 进程中的会话运行，并在对话中流式返回进展；后台子代理在分离的 runner 进程中继续运行，可稍后查看。扩展内置 scout、researcher、evidence-auditor、worker、reviewer、oracle 和 delegate 等代理，并提供 FleetView、检查器和运行记录用于观察工作状态。安装入口是 pi install npm:pi-subagents，因此它适合已使用 Pi 的开发者，而不是独立的通用代理运行时。
安装扩展后，用户可用自然语言要求 Pi 调用 subagent 工具，例如让 reviewer 检查 diff，或让 scout 梳理代码。Pi 启动带有具体任务的子 Pi 会话，并将结果带回父会话；前台运行会在对话中显示进展，后台运行则在 detached runner 中继续。用户可用 /subagents-fleet 查看子代理、读取记录、引导运行中的子代理或停止任务，也可询问当前异步运行。内置 /council 和 council-mode 支持模型顾问讨论；/subagents-doctor 检查设置，/subagents-guide [topic] 提供已安装版本的帮助。
- 开发者想在提交代码前让 reviewer 检查 diff、测试和边界情况。
- 接手陌生代码库的工程师先让 scout 找出入口、数据流和风险，再开始规划。
- 需要并行检查的团队同时委派正确性、测试和复杂度审查。
- 开发者希望先由 oracle 挑战计划假设，再决定是否实施。
- 需要让任务在主会话返回控制后继续运行的用户使用后台子代理，并稍后检查进展。
如何安装或部署这个 Agent？
在已安装 Pi 的环境中运行：
pi install npm:pi-subagentsREADME 将其列为唯一必需步骤。后台子代理使用宿主提供的 SDK：npm 版 Pi 使用其 detached Node runner；Pi 0.86.1 Linux x64 官方独立版通过 Pi 内嵌 SDK 加载同一 runner，无需单独安装 SDK。
如何使用这个 Agent？
安装后，在 Pi 会话中用自然语言发出任务，例如：
Use reviewer to review this diff.也可让多个 reviewer 并行工作：
Run parallel reviewers: one for correctness, one for tests, and one for unnecessary complexity.查看异步运行可询问“Show me the current async runs.”，或打开检查器：
/subagents-fleet检查配置可运行：
/subagents-doctor这个 Agent 有哪些优点和局限？
- 支持前台流式会话和分离 runner 中的后台会话，适合交互式协作和耗时任务。
- 内置侦察、研究、实现、审查和第二意见等不同职责的代理，无需先自行创建代理。
- FleetView、
/subagents-fleet和机器可读运行记录提供运行状态、对话记录及控制入口。 - 提供
/council、保存的工作流和运行树子代理数量上限等编排功能。
- 它是 Pi 扩展，要求采用 Pi 会话和工具体系，不能作为独立子代理产品直接运行。
- README 未说明模型调用费用或免费额度，实际成本取决于所用模型。
- researcher 和 evidence-auditor 的网页研究需要子代理中安装 pi-web-access。
- 独立版后台执行的支持范围明确限于 Pi 0.86.1 Linux x64 官方版本，且文档提到验证门槛。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Pi 子代理 当前 | 77 · 表现良好 | Agent 插件 / 技能 | ★ 4k | 1 天前 | TypeScript | — |
| oh-my-agent 多智能体开发框架 | 48 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.4k | 今天 | TypeScript | Codex · Claude Code |
| OPC —— 一人公司 | 48 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 193 | 1 个月前 | JavaScript | Claude Code |
| Ring — AI Agent 工程实践技能库 | 72 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 218 | 今天 | HTML | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
文档说明子代理仅在 Pi 调用时启动，不会自动后台审查；工具激活要求授权，且配置可限制功能、子进程数并关闭 Orca 集成，因此最小权限和确认机制较清楚（2）。会话、运行产物、镜像文件及子代理输出的数据流有较细说明，并指出镜像上限和私有权限（3）；但敏感内容仍会写入会话和临时镜像，清理仅描述为短暂延迟后执行（2）。依赖版本有固定项且发布流程使用 npm provenance，但缺少所给材料中的漏洞审计或依赖更新策略（1）。Orca 是可关闭的尽力观察器，失败不影响权威运行；发布须经 GitHub 环境审批，提供部分恢复与停止控制，但恢复覆盖面不完整（2）。仓库和作者字段明确，然而发布者在 curated registry 未验证，故归属证据并非完全确证（2）。
README、配置文档与 package 元数据总体相符，描述了多种运行模式与边界；材料未覆盖全部代码，无法确认所有细节一致（2）。Pi 版本要求、依赖和平台限制有说明，CI 覆盖多平台，但部分运行环境和外部程序仍是条件依赖（2）。配置对无效值、失败子任务和不可用工具给出具体错误方向，但所给材料没有完整错误参考（2）。
涵盖审查、侦察、实现、研究、并行工作流和后台任务等场景，并给出自然语言示例（3）。能力边界较明确，包括授权门槛、功能开关、并发/累计预算、平台限制及观察器非权威性（3）。何时启用子代理、工具何时出现及如何调用都有清晰说明（3）。支持 npm Pi、官方 Linux x64 standalone，并说明 Orca 的系统限制；仍受 Pi 版本、模型工具能力和外部集成条件影响（2）。
README、配置、代理、模型、工作流、可观测性等文档分层清楚，安装和入门路径明显（3）。安装只需一条命令且给出 Pi 最低版本，但未提供所给材料可核实的逐步故障排查细节（2）。包名和导出路径稳定可识别，但材料未展示命名兼容策略（2）。提供多种示例、工作流指南、doctor 和按主题帮助入口（3）。明确列出平台、模型工具激活、Orca 可用性和配置行为等限制（3）。MIT 许可证文本完整（3）。有包版本和发布工作流；材料未提供 CHANGELOG 内容以评估变更记录质量（2）。作者字段和发布审批流程可见，但维护承诺、支持响应和更新责任边界未明确（2）。
结果可在对话中查看，也可通过 FleetView、检查器、日志和机器可读产物检查；截断、顺序和失败结果有文档说明（3）。专用子代理、并行审查、后台运行和可复用工作流明确增加 Pi 的委派与监督能力（3）。安装简单且功能可裁剪，但多代理、运行记录和配置复杂度带来额外维护成本（2）。
文档对配置项、参数、平台边界及行为给出具体描述，便于追踪主张（3）。README、package 元数据、许可证和 CI 工作流提供相互补充的证据，但缺少完整实现文件和测试结果（2）。文档能区分用户配置断言、验证行为和最佳努力集成；静态材料仍无法独立确认运行表现（2）。
- 此评估只依据题目提供的静态文件；未执行代码，也未独立验证文档中的测试或运行主张。
- 委派任务和子代理输出可能接触项目文件或被写入会话、运行产物及临时镜像；使用前应检查具体代理权限和数据保留配置。
- 依赖安全审计、维护承诺和 CHANGELOG 细节无法从所给材料确认。
常见问题
安装后会自动在后台审查代码吗？
必须先配置自己的代理吗？
后台任务如何查看或停止？
/subagents-fleet 打开实时检查器，可浏览子代理、读取记录、引导运行中的子代理或停止任务。