@alexeiled/pi-subagents-bridge
桥接pi-tasks与pi-subagents的协议适配器
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@alexeiled/pi-subagents-bridge。 它的用途是：桥接pi-tasks与pi-subagents的协议适配器 完整的 Skill 内容见：https://321skill.com/skills/alexeiled-pi-subagents-bridge/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'创建一个任务，让general-purpose代理写一份简短计划，然后执行它'，桥接器会自动将pi-tasks的spawn请求翻译为pi-subagents的调用，并返回执行结果。例如：TaskCreate(subject="写一份简短计划", agentType="general-purpose")，然后TaskExecute(task_ids=["1"])。
介绍
这个Skill解决了在Pi生态中@tintinweb/pi-tasks和pi-subagents之间协议不兼容的问题。pi-tasks使用v2子代理协议，而pi-subagents只暴露v1 RPC加上异步完成事件，导致TaskExecute无法直接调用pi-subagents。开发者在使用pi-tasks编排任务时，往往需要依赖pi-subagents的智能体能力，但两者接口不匹配，项目无法顺畅衔接。
使用方式很简单，你只需要先安装两个被桥接的扩展（pi install npm:@tintinweb/pi-tasks 和 pi install npm:pi-subagents），再安装本桥接器（pi install npm:@alexeiled/pi-subagents-bridge）。之后就可以通过TaskCreate创建任务，用TaskExecute执行，期间会自动将pi-tasks的spawn/stop请求翻译成pi-subagents的调用，并把异步完成事件转化为任务更新。
它非常适合已经在使用pi-tasks框架、同时需要引入pi-subagents智能体能力的开发者。尤其是那些需要协调多个子代理、或者希望复用pi-subagents中已有智能体（如delegate、scout）来完成复杂任务链的团队。对于需要从任务执行引擎无缝切换到子代理调度的场景，这个桥接器是必不可少的中间层。
建议在搭建多智能体协作系统时统一使用此工具。需要注意的是，它主要解决协议适配问题，并不提供pi-subagents本身的智能体能力；你需要自行安装并配置好pi-subagents。另外，桥接器依赖Node >= 22.19.0，且要求Pi扩展加载功能已启用，低版本环境可能无法运行。
常见问题
pi-subagents-bridge和pi-subagents有什么区别？
pi-subagents是具体的智能体执行框架，而pi-subagents-bridge是连接pi-tasks与pi-subagents的协议适配器，本身不提供智能体能力。
如何检查桥接器是否安装成功？
运行pi list命令，确认@alexeiled/pi-subagents-bridge在列表中，且pi-tasks和pi-subagents也已安装。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/alexeiled-pi-subagents-bridge/raw/index.md 读取 @alexeiled/pi-subagents-bridge 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/alexeiled-pi-subagents-bridge/raw/index.md（查看排版版本）