Agent Skill 核验档案

herdr · Herdr · 9cbd9e

Herdr 是一个面向编码代理的终端多路复用器与运行时，将终端组织为工作区（workspace）、标签页（tab）和窗格（pane），能检测代理身份与状态，并通过 `herdr` CLI 暴露正在运行的会话，供代理检查或控制相邻工作、启动代理和命令、读取输出并等待状态变化。仅在用户明确提到 Herdr 或要求使用 Herdr 时使用。

适用任务

在当前标签页拆分一个兄弟窗格，以交互式 TUI 启动另一个编码代理（如 codex、claude、pi、opencode、omp），提交任务并等待其完成
在独立窗格中运行普通命令（如 just test），等待输出匹配并读取其结果
列出当前工作区的标签页与窗格，检查相邻代理的状态并读取其输出
根据窗格布局智能选择向右或向下拆分，避免生成不可用的窄列或短行

输入

环境变量 HERDR_ENV=1（确认位于 Herdr 管理的窗格内）
注入到每个受管窗格的稳定上下文：HERDR_WORKSPACE_ID、HERDR_TAB_ID、HERDR_PANE_ID
用户提交给代理的任务文本或要执行的命令（通过 pane run 发送）

输出

多数控制命令打印的 JSON 响应（含 result.pane.pane_id 等标识符与状态）
pane read 读取的窗格输出（visible、recent、recent-unwrapped、detection 等来源，text 或 ansi 格式）
代理状态：idle、working、blocked、done、unknown

限制与检查

仅当用户明确提到 Herdr 或要求用 Herdr 检查/控制窗格、标签页、工作区、终端、命令或与其他代理通信时才可使用；不能仅因任务可能受益于后台终端、委派或并行工作而使用
不能从 Herdr 外部检查或控制当前聚焦的 Herdr 会话
已关闭的 tab 和 pane ID 不会被复用；窗格移到其他工作区会获得新的公共 pane ID，变更后必须重新读取响应
不要在活动会话中运行 `herdr server stop`，也不要杀死 Herdr 主进程；不得关闭非自己创建的工作区、标签页、窗格或会话
发任何控制命令前，先执行 test "${HERDR_ENV:-}" = 1，失败则声明不在 Herdr 内并停止
不要裸跑 herdr 进行发现（会启动 TUI），也不要省略参数探测嵌套的变更命令（如 herdr workspace create 会以默认值执行），应使用命令组帮助输出
所有 ID 从 JSON 响应解析，不从侧栏顺序或示例推导；变更操作后重新读取响应
后台工作使用 --no-focus；目标窗格使用 --current 或显式 ID，不依赖其他客户端的聚焦窗格

herdr · Herdr · 9cbd9e

适用任务

输入

输出

限制与检查

搜索

项目详情