@andrewjacop/pi-herdr

让 pi 编排多个可见 AI 代理窗格

开发流程 协调多智能体管理多个AI编码代理编排子代理 通用 ★ 20 更新于 2026-09-13

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@andrewjacop/pi-herdr。
它的用途是:让 pi 编排多个可见 AI 代理窗格
完整的 Skill 内容见:https://321skill.com/skills/andrewjacop-pi-herdr/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'启动一个 pi 代理,帮我分析当前项目的 package.json 依赖,并生成一份更新建议报告。' 它会自动在 herdr 中新建一个终端窗格,运行 pi 并传入你的提示,等待代理完成后将结果直接返回给你。你也可以同时启动多个代理,分别处理不同任务。

介绍

这个 Skill 解决了在开发过程中需要同时运行多个 AI 编码代理(如 pi、Claude、Codex 等)并协调它们工作的问题。实际开发中,开发者经常需要让不同代理并行处理不同任务,但手动管理多个终端窗口效率低,且难以统一监控和回收结果。

使用方式很简单,你只需要先安装 herdr 并启动其服务器,然后通过 pi 会话加载该扩展。之后就可以通过自然语言指令来 Spawn 一个新的代理窗格(例如 ‘在 herdr 中启动一个 pi 代理帮我分析这个数据集’),发送提示词,等待它完成,并在其运行期间随时观察、附加或干预。完成时自动『收获』响应内容,所有操作都在 pi 中完成。

它非常适合需要多代理协作的团队或个人。尤其是那些已经使用 pi 作为主编码代理,同时希望借助 Claude、Codex 等不同工具处理异构任务(如代码审查、测试、文档生成)的开发者。对于需要可见性(能看到每个代理的终端输出)和可干预性(能随时暂停或修改输入)的场景尤为重要。

建议在已经熟悉 pi 和 herdr 基本操作后使用此扩展。需要注意的是,它要求 herdr 服务器必须处于运行状态,且 macOS 上不能通过 brew services 管理 herdr,否则子代理会因 PATH 问题失败。Windows 和 macOS 已测试,Linux 预期可用但未验证。

常见问题

如何安装 herdr?

访问 herdr.dev 下载对应平台的安装包,确保安装后 herdr 命令在 PATH 中,并启动 herdr 服务器。

macOS 下为什么子代理会死掉?

如果通过 brew services 启动 herdr,会继承 macOS 最小 PATH,导致 node 等命令不可用。请直接在终端中运行 herdr 命令启动。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/andrewjacop-pi-herdr/raw/index.md 读取 @andrewjacop/pi-herdr 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。