grok-pi-herdr-orchestration

Installation
SKILL.md

Herdr + grok-pi 子代理编排

本技能把 grok-pi 放进一个由 Herdr 管理的新 tab/pane,并用 shell 脚本提交提示词、读取终端状态、等待完成和清理。它是“可见 PTY 编排”,不是把 TUI 当作普通 stdout 管道。

关键约束

  1. 禁止失联等待。 创建子代理或提交 prompt 后,必须立即进入 wait/run 轮询。轮询间隔默认 5 秒,最大允许 60 秒,绝不使用超过 75 秒的单次 sleep。
  2. 优先使用 run。 run 在同一个命令内完成创建、提交、轮询和输出,避免主代理创建后忘记跟踪。
  3. 默认只读。 脚本默认只开放 read,grep,find,ls。只有用户明确要求修改代码时,才通过 --tools 显式开放写入相关工具,并仍需定期检查。
  4. 每个任务独立 tab。 不要复用用户已有的 pane;脚本会创建自己的 tab,并把 tab_id、pane_id 和运行状态保存到 ~/.local/state/grok-pi-herdr/(可用 GROK_PI_HERDR_STATE_DIR 覆盖)。
  5. 完成判断要有证据。 idle 只能表示当前 pane 没有工作指示器;最终报告还应读取最近输出,确认有回答或明确错误。blocked、exited 和超时都不能报告为成功。
  6. 不要把 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。

先做环境检查

Installs
1
Repository
dwsy/agent
GitHub Stars
24
First Seen
9 days ago
Security Audits