herdr-orchestra

Herdr Orchestra

在 Herdr 中把明确任务交给 worker，并向调用者交付可核验的结果。默认一项任务、一个 worker；调用者负责权限、分工和最终验收。

Router Rules

• 只接管显式 Herdr 编排请求，或已获授权的上层 skill 委派。普通 review 走既有审查流程，简单 pane 查询走官方 herdr 指引或 CLI help；研究 Herdr 文档不启动进程。
• 已被分配为 leaf 的 worker 直接做本职工作，不再次调用此入口。新进程不会自动继承调用者加载的技能：把必要约束放进任务文本。
• 非 Herdr 环境停止本 skill 的会话操作，并说明限制；缺少能力时不偷偷改用其他传输。

Compact Workflow

1. 阅读 委派契约，取得目标、cwd、kind/native argv、输入范围、权限/文件 ownership、输出和验收条件。未指定模型就沿用用户配置。未授权的范围变化才需要补问。
2. 在任何 Herdr 会话控制前检查 HERDR_ENV=1。使用当前 CLI help 确认语法，通过 caller context 取调用 pane；不以 focused pane 代替调用者。
3. 按契约在创建 sibling 与 agent start 前选择 surface：用户明确要求交互 TUI/Agent 则 agent；否则 kind 原生非交互命令能满足验收则 pane；其余 agent。默认在调用 tab/cwd 创建一个 sibling，按布局选 right/down，保持 --no-focus。解析返回 ID，确认 shell 可用。
4. pane surface：pane run 与非碰撞 wait，完成证据是命令退出后的输出，不是 agent idle/done。agent surface：agent start 指定 kind，确认 ready identity 后向任务自有且 idle 的 worker 发送一次完整 assignment，使用 agent prompt --wait 和有限 timeout。start 或 identity 失败时按契约检查同一 pane 并 incomplete；不重复提交或自动替换。blocked、unknown、旧输出都不能证明完成。
5. 按契约收集完整响应，区分 passive read 与可能滚屏的 history read。只读 worker 的截断响应以小段重述恢复；文件 fallback 需要已有写权限。核验实际 scope、证据和缺失项。
6. 交付下列 receipt，保留 worker pane。需要进一步独立分工或异常恢复时阅读 模式与恢复。提交、发布、修复、trust、更改集成或扩大清理均不因编排而获得授权。

Output Contract

• 返回解析得到的 worker name/kind/pane identity，以及本任务创建的资源和保留状态。
• 分开记录已观察的 lifecycle、实际任务/输入范围、收到的响应、覆盖与完整性、错误或待决事项。终端 idle/done 和任务成功是两个判断。
• 调用者对照输入核验结果；不以多 Agent 一致意见代替证据。响应仍缺失时明确 incomplete，不把它压缩成“无问题”。

Evidence

来源与设计取舍见 调研记录，当前评估和限制见 交付记录。本包提供指令契约，不声称本地检查证明真实 server、模型执行或新会话加载。