用途:把调用该技能的智能体变成编排者,为它组建一支角色智能体团队,每个角色在各自的 Herdr 面板中作为真实 CLI 智能体运行。编排者(即从 Herdr 面板中运行本技能的智能体,HERDR_ENV=1)负责拆解任务、下达简报、等待、整合、验证和提交;每个角色是 roles/ 下的 markdown 文件,其 frontmatter 的 kind 决定由哪个 CLI 智能体扮演,herdr CLI 作为传输层。
主要能力:内置角色包括 scouter(梳理代码、找路径)、planner(即编排者本身,spawn planner 会退出码 12 且不打开面板)、designer(按设计系统做 UI)、implementer(实现切片生产代码)、tasker(批量机械编辑)、reviewer(推送前的补丁定位正确性审查)、security-reviewer(有证据的漏洞发现)、researcher、inspector、ui-reviewer、documenter、sub-orchestrator。默认 kind 例如 scouter/researcher/implementer/tasker 为 grok,reviewer/documenter 为 codex,security-reviewer/sub-orchestrator 为 claude,designer/inspector/ui-reviewer 为 agy。角色定义解析顺序为项目 .agents/herdr-roles/<role>.md,然后是本技能的 roles/<role>.md;spawn 时的 --kind 覆盖 frontmatter 默认值。
必要用法:前置检查为 test "${HERDR_ENV:-}" = 1 && command -v herdr >/dev/null && { command -v node >/dev/null && [ "$(node -p 'process.versions.node' | cut -d. -f1)" -ge 20 ] || command -v bun >/dev/null; } && $S init;失败则说明不在 Herdr 内或缺少 Node.js 20+/Bun 并停止,禁止从 Herdr 外部控制 Herdr 会话。首次运行(first_run: true)须先用用户语言说明并获同意后才能 spawn。用 $S init 初始化、$S doctor 检查、$S explain 回答“正在发生什么”、$S title 设置面板标题、$S model 查看解析、$S models 列出模型。
关键限制:报告文件是完成信号,用 dispatch(会等待)、wait 或 status,不要自行轮询 herdr agent get;报告缺失时不得 release --close。每份简报需含 Goal、Expected result、Forbidden、Report 与 no-commit 行,可编辑角色还需 Owned files。切片评审者必须来自与实现者不同的模型家族,除非传 --allow-same-family;标记 partial 的评审项不算通过。状态不要放在 .agents/ 或 .codex/ 下;嵌套编排者不能用沙箱模式 Codex。
适用场景:需要并行实现、研究与评审的编码任务。费用、价格与平台细节资料暂未提供。