@aphotic/pi-mux-subagents
子代理编排框架，支持多终端窗格与多CLI协调
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@aphotic/pi-mux-subagents。 它的用途是：子代理编排框架，支持多终端窗格与多CLI协调 完整的 Skill 内容见：https://321skill.com/skills/aphotic-pi-mux-subagents/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'启动一个并行任务组，分别审查src/backends/安全、src/mux/可靠性和src/tools/正确性，最多3个并发，完成后汇总结果。' 它会自动在三个终端窗格中分别启动子代理，每个窗格实时显示输出，所有任务完成后返回按输入顺序排列的审查结果。
介绍
这个Skill解决了在复杂AI开发流程中，需要同时运行多个子代理但缺乏统一编排和可视化监控的问题。开发者常常依赖单进程串行执行，导致任务等待时间长、无法实时观察中间状态、难以手动干预错误。pi-mux-subagents通过将每个子代理启动到独立的终端窗格（mux-pane），让每个任务在独立的实时终端中运行，可随时查看输出、中断或调整，大大提升了多代理协作的可控性和效率。
使用方式非常灵活。你只需在项目中安装并注册扩展，然后通过JSON配置文件定义任务，支持串行（serially）、并行（parallel）和单次启动三种模式。串行模式使用{previous}传递上一步结果，并行模式可设置maxConcurrency控制并发数。每个任务可以指定cli字段选择运行在pi、Claude Code或Codex下，甚至支持wait: false异步执行，返回orchestrationId后后续通过steer-back消息获取结果。整个操作通过自然语言调用技能即可触发。
它非常适合需要编排多个子代理的AI开发团队、智能体开发者和全栈工程师。尤其适合那些已经在使用pi或Claude Code进行复杂任务分解、需要同时运行多个独立分析或代码审查的场景。例如，在代码审查时并行启动安全审查、可靠性审查和正确性审查，每个子代理在独立窗格中运行，互不干扰，结果按输入顺序汇总。
建议在项目初始化时统一注册此扩展，并为每个子代理明确指定CLI类型以发挥不同工具链的优势。需要注意的是，并行任务的最大并发数默认为4，上限为8，超出部分会排队等待。另外，异步模式下取消任务需要提供正确的orchestrationId，建议在任务上下文管理时记录该ID。
常见问题
如何安装pi-mux-subagents？
使用npm install @aphotic/pi-mux-subagents安装，并在package.json中注册扩展路径。
能不能在Claude Code中使用？
可以。在任务配置中指定`cli: "claude"`即可，子代理将在Claude Code CLI下运行，并可使用Claude原生的工具。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/aphotic-pi-mux-subagents/raw/index.md 读取 @aphotic/pi-mux-subagents 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/aphotic-pi-mux-subagents/raw/index.md（查看排版版本）