SuperAPI AI 工具集

herdr-orchestrator

智能体与模型

查看项目

更新于 11-05 02:59

技能介绍

用途 herdr-orchestrator 是一个面向 herdr 环境的协调型技能,用于组织多个 CLI 智能体并行处理任务。它强调“协调与验收纪律”:自身不提供终端访问,也不增加任务权限;终端操作机制需依赖已安装的 herdr 基础技能,先定位并阅读其 SKILL.md 和 scripts/herdr-task。

主要能力

  1. 范围界定:检查 HERDR_ENV 环境变量。基础技能在受管面板之外会停止运行;只有在人类明确为当前会话覆盖该限制时才可继续,并记录该权限范围。历史覆盖不等于通用权限。协调者保持用户选定角色(如观察者/评估者模式下只写简报、审查和跟踪证据,不亲自实现)。

  2. 任务拆分与简报:按优先级选择独立、可跟踪的问题,依赖工作需等待阻塞项被独立验收。根据可用容量和主机/提供方使用情况限制并发,不向已知耗尽的容量发起任务,也不擅自替换模型或提供方。分配互不重叠的文件或模块,共享构建器、模式、Git 元数据变更和集成点只设一个负责人。每个工作智能体使用 references/brief-template.md,简报与结果保存在问题专属工作目录,记录项目路径、角色、所有权、排除项、依赖、基线、检查项和交接标记。

  3. 检出版本策略:可选择共享的脏工作区(需基线与漂移检查,不得清理、重置、暂存或覆盖已有工作)或 worktree(从 Git 修订开始,排除未提交输入,记录其 ref 与输入来源)。不得将要求审查当前检出静默替换为干净 HEAD 审查。

  4. 启动与验证:维护运行注册表(运行 ID、问题、唯一标签、检出、负责人、简报/报告路径、当前 ID、验收状态)。在操作前将唯一标签解析为当前不透明 ID,标签缺失或重复时先核对映射。使用基础技能辅助脚本配合绝对路径简报启动,不使用 --close-when-done(完成仍需审查)。辅助脚本的延迟与二次回车不证明启动成功,需读取面板确认智能体已加载并开始阅读简报。

  5. 监控与批准:使用有界等待或授权的心跳监控,而非紧轮询;只监控自己负责的标签。每次检查实际权限对话框与拟执行操作,共享权限设置时串行审批。不要凭记忆推断选项编号,不授予通用主机/提供方权限,不通过其他途径重试被拒绝的宽泛授权。出现所有权重叠、来源漂移、意外私有/实时访问、不清楚的破坏性命令或改变范围的权限请求时暂停相关工作并保存证据。

  6. 评估与整合:交接时读取结果、实际范围差异、命令清单和日志,独立重跑有意义的聚焦检查或抽查具体声明一次,先捕获真实退出码再显示过滤输出。智能体报告“完成”不等于验收。将具体必要的修正发回同一工作智能体,问题在满足验收标准前保持开放。并行工作后,若结果需要集成证据,分配合并检出的审查;在一次性副本中运行变更性检查以保留原始报告。区分实际 HEAD 的就绪状态与一次性快照构建成功;离线检查不能证明实时 UI、主机、模型或黄金集质量。

  7. 收尾:保存观察者审查、已接受证据、未解决限制和跟踪器更新。确认工作智能体空闲/完成、报告已保存且无待处理修正后,关闭其刷新后的确切标签;仅关闭人类授权关闭的标签。所有工作评估完毕且无持续动作后删除自己拥有的监控。

适用场景 多 CLI 智能体并行开发、需要独立审查与受监控交接的任务分派、在共享检出上做互不重叠的修改、以及需要保留证据链的协调工作。

限制 不授予终端访问或额外任务权限;基础技能在受管面板外会停止;实时评估、私有数据访问、凭据操作、外部消息、安装、发布、部署和破坏性清理需要任务权限;离线检查不足以证明实时环境或模型质量。具体平台支持、价格与安装细节暂未提供。