@pi9/subagent

为Pi提供支持保留对话、后台运行和递归调用的子代理框架。

安装使用

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

帮我安装这个 AI Skill:@pi9/subagent。
它的用途是:为Pi提供支持保留对话、后台运行和递归调用的子代理框架。
完整的 Skill 内容见:https://321skill.com/skills/pi9-subagent/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

‘启动一个子代理来持续监控系统日志,并在发现错误时通知我。’,它会创建一个在后台运行的子代理,该代理保持在线并定期检查日志,发现异常时通过主代理向你发送警报。或者,

对AI说:‘请递归分析这个项目结构并生成文档。’,它会创建主代理来分解任务,并递归调用多个子代理分别处理不同模块,最后汇总结果。

介绍

该Skill旨在解决在Pi AI平台上构建复杂、多步骤或需要长期记忆的自动化工作流时,代理能力单一、任务无法并发执行以及上下文容易丢失的问题。它通过提供保留对话的子代理、后台运行任务以及递归调用子代理的能力,并辅以实时进度反馈和树级并发限制,让开发者能够构建更强大、更稳定的多代理协作系统。

使用时,开发者可以在Pi的Skill中引入此包,通过定义主代理和子代理,并配置它们之间的通信与递归调用逻辑。主代理可以创建并管理多个子代理,这些子代理可以在后台执行任务,保持独立的对话记忆,并能将复杂任务递归分解为更小的子任务,同时整个任务树的并发度受到统一控制,避免资源过载。

它非常适合需要在Pi平台上开发涉及多轮对话、任务分解、并行处理或需要维护长期会话状态的复杂AI应用的开发者。例如,构建一个智能客服系统,其中主代理负责接待,子代理分别处理查询、工单和回访等并行任务。

建议在规划工作流时,清晰定义主代理与子代理的职责边界,并合理设置树级并发限制以优化性能。注意,由于涉及递归和并发,在调试时需关注代理间的消息传递和状态管理,确保逻辑正确性。

核心特点

与同类单次调用的代理框架相比,它核心支持代理的递归调用和树状任务结构的并发控制,并能让子代理在后台保留独立的对话历史持续运行。

注意事项

不适合对实时性要求极高或任务结构极其简单的轻量级一次性调用场景。

常见问题

子代理的对话历史是如何保留的?

通过框架的保留对话机制,每个子代理拥有独立的、可跨会话持久化的上下文存储。

树级并发限制具体指什么?

指可以限制整个递归代理任务树中,同时处于活动状态的子代理总数,防止资源耗尽。

给 AI 助手的安装指引

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

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