@agwab/pi-subagent
Pi平台的轻量子代理运行时
安装使用
复制下面这段提示词发给你的 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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/agwab-pi-subagent/raw/index.md(查看排版版本)