SuperAPI AI 工具集

mo-herdr

智能体与模型

查看项目

更新于 10-16 03:53

技能介绍

用途

mo-herdr 用于把单个功能从开发推进到经过验证的候选提交(verified candidate commit),整个过程运行在 Herdr 管理的 agent 会话之上。它通过 executor 执行功能、reviewer 评审、必要时 E2E 验证,并以门禁(gate)和裁定机制保证结果可信。

主要能力

  • 预检(preflight):校验 fixture 映射,并要求 HERDR_ENV=1、Node.js 22+、Git 仓库、交互式编排面板、命名的公共 Herdr 命令以及两个经精确 fixture 验证的 reviewer 供应商。
  • 可见拓扑:创建包含 orchestrator、executor、reviewer A/B 以及按需创建的 E2E 面板的布局。
  • actor 生命周期:通过 herdr agent start 启动 actor,通过 herdr agent prompt 提交提示,通过 herdr agent wait 等待完成或阻塞。
  • 评审流程:reviewer A 完成后才启动 reviewer B,按行数/字节预算分片检索,并在首轮屏障处按规则放行给 executor。
  • 候选冻结与失效:任何修复或新 SHA 都会使所有门禁与开放 ID 失效,需重复完整冻结。
  • 裁定与路由:对每条 finding 至多一次裁定,按规范 ID 处理,并遵循方法学定义的方向表与路由。

使用方式

技能要求先完整阅读 references/methodology.md 与 references/herdr-mechanics.md。激活前需解析 fixture 映射(调用方提供 locator,否则使用项目契约路径 docs/phase-0-fixtures.md),并校验 MO_FIXTURE_MAP_V1 与 MO_FIXTURE_SCENARIOS_V1 记录。预检需在本技能自身安装目录运行:

scripts/mo-posture.sh --self-check --shell all scripts/mo-posture.sh --shell <zsh|bash|all> -- <selected-providers>

随后创建可见布局,例如:

herdr pane split --current --direction right --cwd <repo> --no-focus herdr tab create --cwd <repo> --label "mo:<slug>:review" --no-focus herdr pane split --pane <root-pane-id> --direction right --cwd <repo> --no-focus

启动 actor 的示例:

herdr agent start <name> --kind claude --pane <id> --timeout 300000 -- --model <id> --effort <level> herdr agent start <name> --kind codex --pane <id> --timeout 300000 -- --model <id> --config model_reasoning_effort=<level>

提交提示时要求每次携带新鲜的 MO_PROMPT_BOUNDARY_V1 边界行,并以原子方式提交文本与 Enter。

适用场景

适用于在 Herdr 环境中、由一个功能触发、需要多 agent 协作(executor、reviewer、E2E)并带有门禁与裁定机制的开发流程,尤其适合需要可验证候选提交与严格流程控制的场景。

限制

  • 必须在 Herdr 内使用;激活要求 HERDR_ENV=1,缺少或不满足条件时不得激活。
  • 不得虚构 Herdr 状态,不得推断私有 API,也不得使用供应商转录、goal 数据库、hook、verdict 文件或其他回退手段。
  • fixture 映射缺失、不可读、格式错误或后端不符时属于 setup attention,会阻止激活,且不得通过后续读取受跟踪内容来修复。
  • 自动化 Markdown 解析时须使用真实 AST,禁止正则解析 Markdown。
  • 版本校验要求精确匹配的规范化版本、单行 ASCII 且不超过 256 字节等条件,否则视为不支持。
  • 不支持的移动/标签移动假设、pane 关闭或水平分割等操作不被支持。

暂未提供

资料的 official_text 为空;收费、价格、具体支持平台与效果的更多信息暂未提供。