@mickyyy68/pi-subagents
Pi扩展，通过子代理链式、并行执行与TUI澄清任务
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@mickyyy68/pi-subagents。 它的用途是：Pi扩展，通过子代理链式、并行执行与TUI澄清任务 完整的 Skill 内容见：https://321skill.com/skills/mickyyy68-pi-subagents/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我将‘分析用户反馈并生成改进建议’拆分为三个子代理：一个负责情感分析，一个负责关键词提取，一个负责报告生成，并行执行，完成后汇总结果。” 然后Pi-subagents会创建三个并行子代理，分别调用对应能力，最终合并输出；若某个子代理指令模糊，会弹出TUI窗口请您补充细节。
介绍
在构建复杂AI Agent时，单一智能体往往难以高效处理多步骤、多分支的任务。Pi-subagents 作为 Pi 框架的原生扩展，允许你将大型任务拆解为多个子代理，通过链式顺序执行或并行派发来提升处理效率，并借助 TUI（终端用户界面）交互式澄清模糊指令，确保子代理准确理解任务目标。
使用方式非常简单：安装后，在 Pi 环境中直接调用子代理编排功能，定义任务拓扑（如链式流水线或并行分支），并设置每个子代理的角色和指令。当任务存在歧义时，Pi-subagents 会弹出 TUI 窗口引导你补充细节，避免因指令不清导致执行错误。
本扩展特别适合需要频繁协调多个智能体的开发者，例如全栈工程师在拆分前后端开发任务时，项目经理分配团队子任务时，或智能体开发者构建多步骤工作流时。它可以显著降低多智能体系统的集成复杂度，让你专注于业务逻辑而非底层调度。
建议搭配 Pi 框架使用，并确保子代理具备独立完成子任务的能力。对于超长链式任务，注意监控资源消耗；并行执行时需留意子代理间的数据依赖关系。此外，TUI 澄清功能在终端环境表现最佳，GUI 环境下可能需额外配置。
核心特点
相比其他子代理调度工具（如 LangGraph、CrewAI），Pi-subagents 原生集成在 Pi 框架中，无需额外编排中间件，并通过 TUI 交互式澄清机制解决任务歧义，同时支持链式与并行两种执行模式，代码侵入性更低。
注意事项
不适合完全不依赖终端交互的纯 Web 或移动端场景，且需要子代理本身具备独立执行能力，无法处理子代理间强耦合的复杂状态同步。
常见问题
这个扩展支持哪些子代理通信方式？
支持链式（顺序传递结果）和并行（独立执行）两种模式，未来可能加入条件分支和循环。
TUI 澄清功能在 VSCode 等 IDE 中能用吗？
TUI 基于终端标准输入输出，在 VSCode 内置终端中可以正常使用，但若 IDE 终端不支持全屏交互，可能降级为简单文本提示。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/mickyyy68-pi-subagents/raw/index.md 读取 @mickyyy68/pi-subagents 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/mickyyy68-pi-subagents/raw/index.md（查看排版版本）