Agent Skill 核验档案

Herdr

Herdr 是一个面向编码代理的终端多路复用器 Skill，用于在用户明确提到 Herdr 时检查和控制工作区、标签页、窗格、命令及其他代理。它通过 herdr CLI 与当前会话通信，可检查邻近工作、创建终端布局、启动代理和命令、读取输出并等待状态变化。仅在 HERDR_ENV=1（即代理运行于 Herdr 管理的窗格内）时可用。

适用任务

在当前标签页分割一个兄弟窗格并启动一个编码代理（如 codex），通过 agent prompt 提交审查任务并等待完成，再读取其输出
在另一个窗格运行普通命令（如测试），用 pane wait-output 等待特定输出匹配并读取结果
检查当前会话布局与代理状态：列出工作区、标签页、窗格及在线代理，读取代理输出并处理 blocked 状态

输入

用户明确提出的 Herdr 检查或控制请求（涉及窗格、标签页、工作区、命令或其他代理）
HERDR_WORKSPACE_ID、HERDR_TAB_ID、HERDR_PANE_ID 等注入到受管窗格的调用者上下文环境变量
JSON 响应中返回的 workspace、tab、pane、agent 标识符（如 w1、w1:t1、w1:p1 及代理名）

输出

大多数控制命令返回的 JSON 响应（含 ID 与状态）
通过 pane read / agent read 读取的窗格或代理输出（visible、recent、recent-unwrapped、detection 等来源，text 或 ansi 格式）
代理生命周期状态：idle、working、blocked、done、unknown

限制与检查

仅在用户明确提到 Herdr 或要求用 Herdr 时使用；不能仅因任务可用后台终端、委派或并行工作而使用
不能从 Herdr 外部检查或控制聚焦的 Herdr 会话
agent start 需要已存在的可用交互式 shell 窗格，不会创建、分割或移动布局
代理名必须匹配 [a-z][a-z0-9_-]{0,31} 且在在线代理中唯一；agent 命令不接受终端 ID 或裸代理种类标签
备用屏幕上的输出无法通过增大 --lines 从宿主回滚恢复，只能回退让代理写文件
不应关闭非自己创建的工作区、标签页、窗格或会话，也不得从活动会话运行 herdr server stop 或杀死主 Herdr 进程
执行任何控制命令前，先运行 test "${HERDR_ENV:-}" = 1，失败则声明不在 Herdr 内并停止
不要运行裸 herdr 进行命令发现（会启动或附加 TUI），也不要通过省略参数试探会执行的嵌套变更命令（如 herdr workspace create）

项目详情

0