tintinweb/pi-subagents

解决的问题

pi-subagents 是一个为 pi 平台设计的扩展功能，旨在实现自主子代理的创建与编排。它让用户能够超越单一模型的对话模式，通过生成可在后台执行、并行运作或遵循确定性脚本工作流的专用代理，减轻主代理的认知负担并提升复杂任务的效率。

运作方式

该项目实现了一个系统，让父代理可以使用 Agent 工具生成子代理。这些子代理可以配置各自的系统提示词、模型与工具限制。此扩展功能提供了多种编排方法：

• 自主生成：代理可以在后台（异步）或前台（阻塞）执行。
• 脚本工作流：SubagentWorkflow 工具允许使用确定性的 JavaScript 脚本，通过 parallel()、pipeline() 与 phase() 等模式来编排多个代理。
• 代理提及：用户可以通过提示词中的 @handle 语法直接与代理互动，无需在主对话中增加轮次即可引导、恢复或启动代理。
• 隔离性：代理可以在隔离的 Git worktrees 中执行，确保变更在完成后提交至分支。

适用对象

使用 pi 平台且需要管理复杂、多步骤 AI 代理工作流的开发者，特别是那些希望获得具有自主子代理与后台任务管理功能的“Claude Code 风格”体验的开发者。

特色亮点

• Claude Code 风格 UI：包含用于活跃代理的持久化小工具、“FleetView”用于导航运行中的子代理，以及实时对话查看器。
• 并行执行：支持具有可配置并行限制与智能群组通知的后台代理。
• 嵌套子代理：允许代理生成自己的子代理（需选择性启用），并具有深度限制的委派功能。
• 确定性工作流：支持与 Claude Code 的 Workflow 工具兼容的 JavaScript 编排脚本。
• 调度：能够根据 cron 表达式、间隔或单次时间戳注册代理执行。
• 跨扩展功能 RPC：一个事件总线，使其他 pi 扩展功能能够生成、停止并加入子代理。