grok-pi-herdr-orchestration
Installation
SKILL.md
Herdr + grok-pi 子代理编排
本技能把 grok-pi 放进一个由 Herdr 管理的新 tab/pane,并用 shell 脚本提交提示词、读取终端状态、等待完成和清理。它是“可见 PTY 编排”,不是把 TUI 当作普通 stdout 管道。
关键约束
- 禁止失联等待。 创建子代理或提交 prompt 后,必须立即进入
wait/run轮询。轮询间隔默认 5 秒,最大允许 60 秒,绝不使用超过 75 秒的单次sleep。 - 优先使用
run。run在同一个命令内完成创建、提交、轮询和输出,避免主代理创建后忘记跟踪。 - 默认只读。 脚本默认只开放
read,grep,find,ls。只有用户明确要求修改代码时,才通过--tools显式开放写入相关工具,并仍需定期检查。 - 每个任务独立 tab。 不要复用用户已有的 pane;脚本会创建自己的 tab,并把
tab_id、pane_id和运行状态保存到~/.local/state/grok-pi-herdr/(可用GROK_PI_HERDR_STATE_DIR覆盖)。 - 完成判断要有证据。
idle只能表示当前 pane 没有工作指示器;最终报告还应读取最近输出,确认有回答或明确错误。blocked、exited和超时都不能报告为成功。 - 不要把
grok-pi当作普通 headless CLI。grok-pi --print-capabilities表明它内部使用 Pi JSONL RPC,但grok-pi自己负责 TUI/PTY;在 Herdr 中通过pane send-text+pane send-keys驱动最稳定。不要直接把用户 prompt 管道到grok-pi的 stdin。