@aphotic/pi-mux-subagents
为 Claude Code 和 Pi 设计的交互式多子代理框架。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@aphotic/pi-mux-subagents。 它的用途是：为 Claude Code 和 Pi 设计的交互式多子代理框架。 完整的 Skill 内容见：https://321skill.com/skills/aphotic-pi-mux-subagents/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“启动 pi-mux-subagents 的交互模式，并创建两个子代理，一个负责代码静态分析，另一个负责生成单元测试。” 它会启动一个终端多窗格界面，你可以分别向两个窗格中的子代理下达指令，并实时观察它们的输出和交互。
介绍
该 Skill 旨在解决开发者在处理复杂任务时，需要多个 AI 子代理协同工作的问题。它提供了一个框架，允许你创建、管理和协调多个 AI 子代理，无论是同步还是异步执行任务，并能通过 mux-pane 支持在终端中交互式地查看和控制各个子代理的运行状态。
使用方式非常灵活。你可以通过其提供的多 CLI 设计，快速启动一个交互式会话，在其中创建和管理子代理。每个子代理可以独立运行，也可以相互通信和协作，共同完成一个更大的目标，比如并行处理代码审查、数据分析和文档生成等任务。
它非常适合需要将复杂任务分解、由多个 AI 代理并行或按流程处理的开发者、技术团队或研究人员。尤其适合那些已经在使用 Claude Code 或 Pi 进行开发，并希望提升自动化协作效率的用户。
使用建议是，先从简单的任务和少数几个子代理开始，熟悉其同步/异步编排机制。注意事项包括，合理规划子代理间的通信和数据传递，避免因过度复杂的编排导致性能瓶颈或逻辑混乱。
核心特点
核心区别在于其深度融合了交互式（mux-pane）和无头（headless）两种运行模式，并提供了明确的同步/异步编排能力，而同类框架往往只侧重其中一种模式或编排方式。
注意事项
不适合对终端交互和 CLI 操作不熟悉的纯前端或非技术用户。
常见问题
pi-mux-subagents 是什么？
一个用于 Claude Code 和 Pi 的多子代理协作框架，支持交互式面板和异步编排。
如何启动交互式面板？
运行框架提供的特定 CLI 命令即可进入交互式 mux-pane 管理界面。
给 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（查看排版版本）