@minhduydev/pi-subagents
Pi 子代理委托运行时，编排持久任务与前后台代理
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@minhduydev/pi-subagents。 它的用途是：Pi 子代理委托运行时，编排持久任务与前后台代理 完整的 Skill 内容见：https://321skill.com/skills/minhduydev-pi-subagents/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我用 @minhduydev/pi-subagents 创建一个后台子代理，每5分钟检查一次 Pi 网络交易状态，并将结果持久化。' 它会生成一个集成代码，通过 npm 安装包后，实例化运行时，使用 `createSubAgent({ type: 'background', schedule: '*/5 * * * *', task: checkTransaction })` 启动代理，并自动处理心跳、恢复和日志记录。
介绍
在 Pi 生态中开发多代理协作系统时，任务状态管理、代理生命周期控制和跨工作树隔离是常见痛点。@minhduydev/pi-subagents 提供了一个原生的委托运行时，让开发者能够以声明式方式管理子代理的创建、执行、回收和恢复，并内置持久化任务状态、心跳保活、证据审查门等机制，确保代理任务在复杂环境下可靠运行。
该 Skill 通过简单的 API 调用即可启动前台或后台子代理，每个子代理拥有独立的工作树隔离，避免资源冲突。支持任务分组完成、计划调度、RPC v3 通信，以及基于 SDK 或 tmux 的 fallback 模式。开发者只需在 Pi 项目中安装 npm 包，导入运行时模块，即可快速集成子代理编排能力，无需从零搭建基础设施。
适合智能体开发、后端开发以及构建 Pi 扩展的开发者。如果你正在开发需要多步骤、长期运行或可恢复的代理任务（如数据采集、自动化流程、持续监控等），这个 Skill 能显著降低状态管理和故障恢复的复杂度。对于需要严格审计和独立审查的场景（如合规操作），其内置的证据门和审查机制尤为实用。
使用前建议熟悉 Pi 平台的基本开发流程，并确保 Node.js 环境满足依赖要求。注意该运行时专注于任务编排与状态管理，不直接提供具体的业务逻辑，需要结合自定义代理代码使用。对于超轻量级单次代理调用，可能显得过度设计，建议根据实际任务复杂度评估是否引入。
核心特点
相比通用代理编排框架，@minhduydev/pi-subagents 深度绑定 Pi 生态，原生支持持久任务状态、工作树隔离和证据审查门，并提供 SDK/tmux 双 fallback 模式，确保在 Pi 网络环境下子代理的可靠恢复与审计合规。
注意事项
不适用于与 Pi 平台无关的通用代理场景，且需要 Node.js 运行环境，无法在纯浏览器或非标准 Node 环境中使用。
常见问题
这个 Skill 是否支持 Pi 主网？
该运行时设计为 Pi 原生，但具体主网兼容性请参考官方文档，建议在测试网先行验证。
如何升级子代理的任务状态？
通过内置的持久化 API 可随时保存和恢复任务状态，支持心跳保活和自动恢复机制。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/minhduydev-pi-subagents/raw/index.md 读取 @minhduydev/pi-subagents 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/minhduydev-pi-subagents/raw/index.md（查看排版版本）