@eggmasonvalue/pi-subagent
为PI模型提供可观察、可操控的子代理框架。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@eggmasonvalue/pi-subagent。 它的用途是：为PI模型提供可观察、可操控的子代理框架。 完整的 Skill 内容见：https://321skill.com/skills/eggmasonvalue-pi-subagent/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用子代理框架分析这份长文档，并每完成一个章节就向我汇报关键点。”，它会创建一个子代理来执行文档分析任务，并允许你在分析过程中随时暂停、查看已完成的章节摘要，或在超时后获取已处理部分的结果。
介绍
该Skill旨在解决在复杂AI任务中，主代理难以对子任务进行精细控制和状态追踪的问题。它提供了一个框架，允许主代理创建具有独立上下文的子代理来执行特定任务，同时主代理可以观察其进度、在任务中途恢复执行，并在中断或超时时获取部分结果。
使用时，开发者需在基于PI模型的AI项目中引入此包，通过其API创建和管理子代理。它采用精简的、面向机器的通信格式，并支持可选的白名单机制来限制子代理可使用的模型，从而在灵活性和可控性之间取得平衡。
它非常适合需要将大型或长时间运行任务分解为可管理、可监控子步骤的AI应用开发者，例如构建需要分步执行、状态持久化或容错处理的自动化工作流。
建议在需要任务隔离和中间结果检查的场景中使用。请注意，其设计偏向于程序化集成，对纯自然语言交互的直接支持可能有限，更适合在代码层面进行调用和控制。
核心特点
核心在于提供了“可恢复”和“可中断并刷新部分结果”的能力，允许主代理在任何时间点接管或重启子任务，并获取其已完成的中间产物，这比简单的任务委派提供了更强的可控性和容错性。
注意事项
不适合对实时性要求极高或任务极其简单、无需状态追踪和控制的场景。
常见问题
pi-subagent 是什么？
它是一个为PI模型设计的子代理管理框架，用于创建可观察、可操控的独立任务代理。
如何中断子代理并获取结果？
框架支持在超时或主动中断时，自动将子代理已产生的部分结果返回给主代理。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/eggmasonvalue-pi-subagent/raw/index.md 读取 @eggmasonvalue/pi-subagent 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/eggmasonvalue-pi-subagent/raw/index.md（查看排版版本）