安装

pi install npm:pi-subagents

这是唯一必需的安装步骤。无需手动创建智能体、编写配置或学习斜杠命令。

从这些请求开始

Use reviewer to review this diff.
Ask oracle for a second opinion on my current plan.
Use scout to understand this code, then ask clarification questions.
Run parallel reviewers for correctness, tests, and unnecessary complexity.

直接用自然语言描述即可。Pi 会决定是否调用 subagent 工具、选择哪个智能体，以及如何组合工作。

工作方式

Pi 是父会话；subagent 是拥有独立任务的专注子 Pi 会话。父会话启动子会话、分配任务，并把结果带回当前对话。

• 前台任务会在当前对话中持续显示进度。
• 后台任务在控制权返回后继续运行，可稍后查看或引导。
• 安装扩展不会自动启动审查器；需要在提示词或项目规则中明确要求审查。
• 单棵运行树默认最多累计创建 64 个逻辑子智能体，和并发限制相互独立。

内置智能体

常用工作流

推荐的实现循环是：澄清 → scout → worker → 全新 reviewer → worker。

查看运行中的工作

TUI 会在编辑器下方显示持久 FleetView。/subagents-fleet 可打开实时检查器，浏览子会话、读取记录、引导运行中的子智能体或停止任务。

若配置异常，运行 /subagents-doctor；也可以使用 /subagents-guide [topic] 查看工作流、智能体、可观测性、配置和模型等主题。

出现异常时

/subagents-doctor

也可以直接让 Pi 检查 subagents 与 intercom 是否配置正确。安装版本的帮助入口是 /subagents-guide [topic]，默认主题为 overview。

• 可查询的主题包括 workflows、agents、missions、observability 与 tool-reference。
• 还包括 configuration、models、watchdog 和 extension-api。
• 同样可以调用 subagent({ action: "guide", topic: "workflows" }) 获取指定主题。

完整文档

项目的 docs/ 目录提供更深入的参考资料，覆盖自定义智能体、模型策略、编排、运行可观测性和扩展 API。

• Agents ↗自定义智能体、frontmatter、覆盖内置定义、工具、扩展、Skill 与每个智能体的记忆。
• Models ↗默认模型、角色级覆盖、层级建议、fallback、thinking level 与 profile。
• Workflows ↗编排模式、提示词快捷方式、脚本工作流、worktree 隔离与递归保护。
• Watchdog ↗可选的对抗式改动审查、范围监测、LSP 检查与子智能体权限。
• Tool reference ↗subagent 的参数、管理动作、状态控制、验收门槛与外部 CLI runner。
• Observability ↗FleetView、检查器、生命周期产物、事件、日志与会话共享。
• Missions and schedules ↗持久任务记录、交付回执、定时与重复运行。
• Configuration ↗config.json 的全部选项与环境变量。
• Extension API ↗RPC、委派 API、preflight、能力上限与后台工作提供者。