用途:把已验证的 AGER/OKF AgentGraph 编译为 Orca ADE(来自 Stably AI)的编排配置。Orca 本身没有原生 AGER YAML,因此该插件负责翻译,生成 orca-project.yaml、命名的 worker-start --name、隔离的 git worktree、远程控制 rename 映射,以及使用官方 Orca 技能的协调器。编写 AgentGraph 的工作由 okf-agent-graph 负责。
前置要求:编译后的舰队在 Orca 中运行,需先安装并加载两个对等技能:
npx skills add https://github.com/stablyai/orca --skill orca-cli --global npx skills add https://github.com/stablyai/orca --skill orchestration --global orca skills get orca-cli orca skills get orchestration --full
主要能力(映射要点):AgentGraph 对应 Orca Project / Run;OrchestratorAgent 对应命名 lead 会话(无隔离工作树);WorkerAgent 对应经 orca-cli 在隔离 git worktree 中的命名 agent;JudgeAgent 对应专用 judge 工作树并写出 critique markdown;SynthesizerAgent 对应 orchestration DAG 上的调解步骤;GuardrailAgent 对应针对计划的最终 spec 复核;HumanGate 对应 orchestration gate-create;FanOut / ParallelGroup 对应每个 agent 一个并行命名工作树;LoopPolicy 对应任务预算、max_turns、deadline、no_progress;ScratchPad 对应 docs/planning/ 与 artifacts/。命名角色必须采用 <Host>-<Role> 形式(如 Claude-Plan-Drafter、Grok-Mediator)。远程控制策略为 rename(默认)或 disable。
使用方式:定位 AGER bundle,如存在则用 ager-validate 验证;确认已安装 orca-cli 与 orchestration 并加载实时指南,不要猜测 Orca 参数;运行确定性 emitter,不要手工搭建目录树:
python3 scripts/emit.py --bundle <AGER_ROOT> --out <OUT> python3 scripts/emit.py --bundle <AGER_ROOT> --out <OUT> --remote-control disable python3 scripts/emit.py --bundle <AGER_ROOT> --out <OUT> --name-prefix Fleet python3 scripts/validate.py --bundle <AGER_ROOT>
报告写入路径后需确认:每个 agent 符合 <Host>-<Role>;并行工作树不重叠;每个 SYSTEM.md 指示 agent 执行 orca skills get orca-cli 与 orca skills get orchestration --full;scripts/run-feature.sh 使用 orca-cli worktrees(而非原生 git)与 orchestration 原语;存在 agents/Orca-Coordinator/SYSTEM.md。
限制:插件内置的发现存根位于 skills/orca-cli 与 skills/orchestration,但它们并非命令参考,运行时二进制才是权威。未经测试不得声称生产就绪。主机不计量 USD,需记录预算并停止。参考文档包括 references/mapping.md、docs/SPEC.md、https://github.com/stablyai/orca、https://www.onorca.dev/docs/cli/skills。