Herdr Skill 安全审计

2name: herdr3description: "Control Herdr, a terminal multiplexer for coding agents. Use only when the user explicitly mentions Herdr or asks to use Herdr to inspect or control panes, tabs, workspaces, commands, or another agent. Do not use merely because a task could benefit from a background terminal, delegation, or parallel work. Requires HERDR_ENV=1."4---

171172`pane run` atomically sends command text and Enter. `pane wait-output` searches the selected snapshot immediately, so output that already exists can match. Use `--match <text>` for a literal substring or `--regex <pattern>` for a Rust regular expression. Omitting `--timeout` allows an indefinite wait.173

148149```bash150herdr agent get reviewer151herdr agent read reviewer --source recent-unwrapped --lines 120152```153

173174Use the read source that matches the task:175176- `visible`: the currently rendered viewport.177- `recent`: recent rendered output, including soft wraps.178- `recent-unwrapped`: recent output with soft wraps joined; prefer it for logs and transcripts.179- `detection`: the plain-text bottom-buffer snapshot used for agent detection.180181Use `--format ansi` when colors and terminal styling are evidence. Otherwise use text.182

146147Herdr validates all keys before writing any bytes. Read the result through the resolved agent:148149```bash150herdr agent get reviewer151herdr agent read reviewer --source recent-unwrapped --lines 120152```153

163164Read the new pane ID from `.result.pane.pane_id`, then run and inspect the command:165166```bash167herdr pane run <returned-pane-id> "just test"168herdr pane wait-output <returned-pane-id> --match "test result" --timeout 120000169herdr pane read <returned-pane-id> --source recent-unwrapped --lines 120170```171

99100Split a wide pane to the right and a narrow or tall pane down. Avoid repeated same-direction splits that create unusably narrow columns or short rows. Keep the user's focus in the calling pane and explicitly preserve the caller's working directory:101102```bash103herdr pane split --current --direction right --cwd "$PWD" --no-focus104```105

107108An available shell pane must be at its interactive prompt, with the shell itself in the foreground and no foreground command, editor, or agent running. Start a supported agent in that pane with a useful unique name:109110```bash111herdr agent start reviewer --kind codex --pane <returned-pane-id>112```113114Use the kind requested by the user. Run `herdr agent` to inspect the installed kind list and options. Pass native agent arguments only after `--`:115116```bash117herdr agent start reviewer --kind codex --pane <returned-pane-id> -- <agent-args...>118```

121122Submit work through the agent surface:123124```bash125herdr agent prompt reviewer "Review the current diff and report only actionable findings." --wait --timeout 120000126```127

153154If a wait fails or returns `blocked`, inspect `agent get` and `agent read` before deciding what input to send. Use the pane surface only when raw terminal control is intentional.155

189- Use `--no-focus` for background work unless the user asked to switch context.190- Use `--current`, an explicit pane ID, or a unique agent name. Do not rely on another client's focused pane.191- Parse IDs from JSON responses. Do not derive them from sidebar order or examples.

146147Herdr validates all keys before writing any bytes. Read the result through the resolved agent:148

127128`agent prompt` honors the pane's live bracketed-paste mode and sends text followed by encoded Enter after a short delay. It rejects an agent already waiting at an approval or question dialog with `agent_blocked` before sending any input. Inspect the blocked UI and ask the user before answering it. For normal agent work, `--wait` is enough: it waits for the first settled `idle`, `done`, or `blocked` state. Do not repeat those defaults with `--until`.129

188189- Use `--no-focus` for background work unless the user asked to switch context.190- Use `--current`, an explicit pane ID, or a unique agent name. Do not rely on another client's focused pane.191- Parse IDs from JSON responses. Do not derive them from sidebar order or examples.