@agwab/pi-subagent

Pi平台的轻量子代理运行时

开发流程 协调多智能体编排子代理创建测试环境容器沙箱分配资源 通用 ★ 48 更新于 2026-09-13

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@agwab/pi-subagent。
它的用途是:Pi平台的轻量子代理运行时
完整的 Skill 内容见:https://321skill.com/skills/agwab-pi-subagent/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'Run three reviewers in parallel for this change.' 它会自动创建三个独立的子代理,分别执行安全审查、性能审查和测试覆盖审查,每个子代理使用独立的沙箱和上下文,最终返回合并后的审查结果。你也可以说:'Start a background audit and let me inspect it in /subagent panel.' 它会在后台启动一个审计子代理,你随时可以通过面板查看进度和工件。

介绍

这个Skill解决了Pi环境中缺乏轻量级子代理隔离运行能力的问题。在实际开发中,开发者经常需要让AI同时执行多个独立任务(如并行审查、沙箱测试、后台审计),但Pi默认的单一会话无法提供并行扇出、资源隔离和持久化工件管理,导致任务混杂、上下文污染。

使用方式很简单,你只需要在Pi中安装此包并重新加载,即可通过自然语言指令调用subagent工具。例如,对AI说“Run three reviewers in parallel for this change.”,它会自动创建三个独立的子代理分别处理安全、性能和测试覆盖审查;你也可以指定sandbox: true隔离网络访问,或worktree: true在git工作树中隔离文件变更。所有运行结果(尝试、工件、日志)都会记录,并可通过/subagent面板实时查看。

它非常适合需要并行任务编排、沙箱执行或后台异步监控的团队或个人。尤其是那些已经使用Pi作为AI编码助手,但希望扩展其能力以支持复杂工作流(如多智能体协作、代码审查流水线、自动化测试隔离)的开发者。运维工程师和测试工程师也能利用它创建隔离的测试环境,批量执行安全检查。

建议在需要进行多步骤、多角色并行处理的场景中统一使用此工具,避免在同一会话中混入过多上下文。需要注意的是,它主要依赖Node.js>=22.19.0和macOS/Linux环境,原生Windows不支持,需使用WSL2;同时sandbox: true会禁止所有网络访问,若需调用模型API需明确添加允许域名。

常见问题

如何安装pi-subagent?

在Pi终端中运行 `pi install npm:@agwab/pi-subagent`,然后重新加载Pi即可。需要确保Node.js版本>=22.19.0。

是否支持Windows?

原生Windows不支持(涉及POSIX进程组、tmux和which命令),建议使用WSL2。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/agwab-pi-subagent/raw/index.md 读取 @agwab/pi-subagent 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。