@nklisch/pi-subagents
Pi扩展的有序生命周期拦截子代理工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@nklisch/pi-subagents。 它的用途是：Pi扩展的有序生命周期拦截子代理工具 完整的 Skill 内容见：https://321skill.com/skills/nklisch-pi-subagents/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我要在Pi扩展中管理三个子代理，分别负责数据清洗、特征提取和模型推理，请用@nklisch/pi-subagents按照顺序执行，并确保每个子代理完成后才进入下一个。' 它会自动生成配置代码，注册子代理并设置生命周期拦截器，输出可运行的 Node.js 集成示例。
介绍
开发Pi扩展时，管理多个子代理的生命周期和调用顺序是一项常见痛点。@nklisch/pi-subagents 提供了一套有序的生命周期拦截机制，让你能精确控制每个子代理的初始化、执行和销毁顺序，避免因调度混乱导致的逻辑错误或资源竞争。
使用方式非常直接：通过 npm 安装后，在 Pi 扩展项目中引入，按照文档配置各子代理的拦截顺序和生命周期钩子。该库会自动接管子代理的注册、排序和调度，你只需专注业务逻辑，无需手动处理繁琐的协调代码。
适合正在开发或维护 Pi 扩展的智能体开发者、全栈工程师，尤其是那些需要多个子代理协同完成复杂任务（如多步骤数据处理、流水线式推理）的场景。如果你已经在使用 pi-subagents 原版，但需要更稳定的维护和增强的生命周期控制，这个 fork 就是为你准备的。
建议在项目初期就引入有序生命周期管理，避免后期重构。注意该库依赖 Pi 扩展框架，不适用于独立应用或非 Pi 环境。使用前请阅读 README 中的生命周期顺序配置示例，确保拦截器优先级设置合理。
核心特点
与原始 pi-subagents 相比，本 fork 引入了有序生命周期拦截器，确保子代理按指定顺序执行初始化、任务处理和清理，而不仅仅是无序注册。
注意事项
不适用于没有使用 Pi 扩展框架的普通 Node.js 应用或独立微服务场景。
常见问题
pi-subagents 和这个 fork 有什么区别？
原版 pi-subagents 没有生命周期顺序控制，这个 fork 增加了有序拦截机制，并且保持 MIT 许可持续维护。
如何配置子代理的执行顺序？
在注册子代理时传入 priority 或 order 参数，库会按你指定的顺序调用生命周期钩子。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/nklisch-pi-subagents/raw/index.md 读取 @nklisch/pi-subagents 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/nklisch-pi-subagents/raw/index.md（查看排版版本）