tintinweb/pi-subagents

解决的问题

pi-subagents 是 pi 平台的扩展，支持创建和编排自主子代理。它允许用户启动具有独立工具、系统提示和模型的专用代理，以在后台或并行处理复杂任务，从而减轻单一主代理的认知负担。

工作原理

该扩展引入了一个 Agent 工具，主模型可使用它来启动子代理。这些代理可在隔离的会话中运行——默认在后台运行，或阻塞主会话。用户可通过 Markdown 文件中的 YAML 前置元数据定义自定义代理类型，指定系统提示、模型选择和工具限制。

关键编排机制包括：

• 脚本化工作流：SubagentWorkflow 工具可执行确定性的 JavaScript 脚本，通过 parallel()、pipeline() 和 phase() 等模式管理代理。
• 代理提及：在提示中使用 @handle 语法，可与代理通信、恢复或启动代理，而无需消耗主对话的回合数。
• FleetView：编辑器下方的可导航 UI 列表，用于监控和跳转至实时代理对话。
• Git 隔离：支持在隔离的仓库副本中运行代理，完成后自动将更改提交到分支。

适用人群

需要在 pi 平台上管理多个专用 AI 代理以处理复杂软件工程任务的开发者，特别是希望获得 Claude Code 风格的自主子代理编排体验的用户。

特性亮点

• 并行执行：可配置并发限制地启动多个后台代理。
• 自定义代理类型：通过项目或全局配置文件定义具有自定义提示和工具集的专用代理。
• 确定性工作流：运行与 Claude Code 的 Workflow 工具兼容的基于 JavaScript 的编排脚本。
• 实时监控：提供持久化小部件和 FleetView，可实时跟踪 token 数量、工具活动和代理状态。
• 运行中调控：可向正在运行的代理注入消息，以重新定向其工作，而无需重启。
• 会话恢复：通过保存完整的对话上下文，可从代理中断处继续执行。
• 调度支持：支持 cron、间隔和一次性调度代理任务。