pi-tmux-subagents
基于tmux和Markdown创建并行AI子代理，实现协同编程
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-tmux-subagents。 它的用途是：基于tmux和Markdown创建并行AI子代理，实现协同编程 完整的 Skill 内容见：https://321skill.com/skills/pi-tmux-subagents/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请使用pi-tmux-subagents，根据`plan.md`中的定义，启动三个子代理分别负责API模块、数据库模块和前端组件的开发。’，它会解析你的Markdown配置，在后台启动三个tmux窗格，每个窗格运行一个专注于特定任务的AI代理，并开始并行输出代码。你可以随时切换tmux窗格查看各自进度。
介绍
这个Skill解决了在复杂编程任务中，单一AI代理难以同时处理多个并行子任务或上下文切换成本高的问题。它允许用户通过Markdown文件定义多个具有特定角色和目标的子代理，并在后台的tmux会话中并行运行它们，从而实现任务分工与协作。
使用时，用户需要安装此npm包，并准备一个描述子代理配置的Markdown文件。通过向主AI代理（如Pi）发送指令，可以启动、管理和监控这些在独立tmux窗格中运行的子代理，让它们同时处理代码编写、审查、测试等不同工作。
它非常适合需要多线程思考或并行执行任务的开发者、技术负责人或研究员。例如，在开发新功能时，可以同时让一个代理写核心逻辑，另一个写单元测试，第三个编写文档，大幅提升复杂项目的推进效率。
建议在Linux/macOS等支持tmux的环境中使用，并确保对tmux有基本了解。注意管理好子代理的生命周期和输出，避免产生过多后台进程。对于简单的、线性的编码任务，可能不需要使用此工具。
核心特点
核心区别在于它利用tmux实现了真正操作系统级别的、持久化的并行AI代理执行环境，而非模拟的或顺序的“多角色”对话；并且其代理配置和协作流程通过结构化的Markdown文件定义，易于版本管理和复用。
注意事项
不适合在Windows（无原生tmux）、Web IDE环境或只需要简单线性对话的任务中使用。
常见问题
pi-tmux-subagents 是什么？
它是一个Pi扩展，用于通过Markdown定义并在tmux中并行运行多个AI编码子代理。
需要提前安装tmux吗？
是的，必须在你的系统上预先安装并配置好tmux。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-tmux-subagents/raw/index.md 读取 pi-tmux-subagents 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-tmux-subagents/raw/index.md（查看排版版本）