Community研究与数据分析github.com

zeromountain/orca-role-orchestration

Orca Agent IDE 的多模型角色编排技能,实现基于模型能力的任务分发与监督执行。

orca-role-orchestration 是什么?

这是一个专为 Orca Agent IDE 设计的角色编排技能,它定义了一个固定的四角色架构(架构师、执行者、节俭者、回退者),每个角色绑定特定的模型和启动命令。核心原理是:Opus 深入设计,Sol 闭环执行,Grok 广泛探索,Gemini Flash 作为回退。技能通过 `orca-role-orchestration` 目录下的脚本实现安装引导、角色启动、任务分发和限流回退等功能,并支持监督式生命周期(dispatch/check/wait)和非生命周期的手动交接。技能还提供了路由速查表和标准 DAG 流程(architect → executor/thrifty → architect review),适用于需要多模型协作、成本控制和严格质量管理的开发场景。

兼容平台✓Claude Code✓Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add zeromountain/orca-role-orchestration

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Orca 角色编排

适用于 Orca Agent IDE 的可移植四角色设置。协调器根据模型强度分配工作;工人在监督式调度下报告 worker_done。

角色(固定)

角色模型启动命令
architectClaude Opus 4.8claude --model claude-opus-4-8 --dangerously-skip-permissions
executorGPT-5.6 Solcodex --model gpt-5.6-sol -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox
thriftyGrok 4.5grok --model grok-4.5 --permission-mode bypassPermissions
fallbackGemini 3.5 Flash (Medium)agy --model "Gemini 3.5 Flash (Medium)" --dangerously-skip-permissions

原则:Opus 深入,Sol 闭环,Grok 拓宽。限制 → agy Flash Medium。

仅在用户询问为何选择某个角色时加载 references/model-roles.md。

前置条件

orca status --json   # runtime.reachable true
# 设置 → 实验性 → Agent 编排 开启
which orca claude codex grok agy

如果项目不在 Orca 中:orca repo add --path <abs-project-root>。

技能布局

orca-role-orchestration/
  SKILL.md
  scripts/
    install-to-project.sh      # 脚手架安装到任意仓库
    orca-bootstrap-roles.sh
    orca-dispatch-role.sh
    orca-fallback-on-limit.sh
  templates/                   # 由 install 复制到项目中
  references/model-roles.md

从本文件所在目录解析技能根目录。标准安装路径为:

~/.agents/skills/orca-role-orchestration/ (Grok 也可能看到 ~/.grok/skills/orca-role-orchestration → 符号链接)

默认工人启动命令绕过了提供商的权限检查。仅在受信任的仓库中使用,或在引导前移除绕过标志。

模式

A) 将脚手架安装到当前项目(首次或新仓库)

SKILL=~/.agents/skills/orca-role-orchestration
"$SKILL/scripts/install-to-project.sh" --project-root "$(pwd)"
# 可选:--project-name my-app --force

创建:

  • .orca/orchestration/roles.yaml(单一真实来源)
  • .orca/orchestration/PLAYBOOK.md、SCRIPTS.md、handles.example.json
  • scripts/orca-{bootstrap-roles,dispatch-role,fallback-on-limit}.sh
  • gitignores 添加 handles.json;如果 AGENTS.md 存在,则追加简短 AGENTS.md 章节

然后自定义 roles.yaml 中的 project_hints,并将 AGENTS.md 约束合并到路由中。

B) 引导角色工人

./scripts/orca-bootstrap-roles.sh --worktree path:$(pwd)

写入 .orca/orchestration/handles.json。在关闭标签页/无效句柄后重新运行。如果旧的 role-* 标签页仍打开,则可能出现重复标签页——当需要干净状态时,请先关闭它们。

C) 路由 + 监督式调度

仅在用户想要协调/监督/等待/DAG/结果时使用 监督式 生命周期:

  1. 读取 .orca/orchestration/roles.yaml 的路由表(以及 AGENTS.md)。
  2. 选择主要角色(如果是双路径则选择次要角色)。
  3. 调度:
./scripts/orca-dispatch-role.sh architect --spec "仅规划:<目标>。遵循 AGENTS.md。"
./scripts/orca-dispatch-role.sh executor  --spec "实施已批准的计划:…"
./scripts/orca-dispatch-role.sh thrifty   --spec "只读映射:…"
  1. 使用滚动窗口等待(超时 ≠ 失败):
orca orchestration check --wait \
  --types worker_done,escalation,decision_gate \
  --timeout-ms 900000 --json
  1. 遇到速率/会话限制时:
./scripts/orca-fallback-on-limit.sh --from <role|term_*> --spec "继续:<目标 + 部分结果>"

D) 完全交接(无生命周期)

如果用户说“交接 / 넘겨줘”而不使用监督语言:不要 创建任务/调度/检查。仅使用 orca terminal send 或非生命周期的 worktree 交接。请参阅通用 orchestration 技能的归属规则。

路由速查表

用户需求角色
设计、模糊范围、高风险评审architect
困难实现、调试、类型检查/构建、关闭 PR 单元executor
小修复、代码映射、研究、原型thrifty
主要遭遇会话/速率/配额限制fallback

标准 DAG:architect(计划) → executor|thrifty(实现) → architect(仅评审)。 成本阶梯:thrifty → executor → architect。

规格规范

脚本会自动添加前缀 [ROLE=<角色> | <模型>]。正文应包括:

  • 目标(一句话描述最终状态)
  • 约束(来自 AGENTS.md / 产品护栏)
  • 允许的文件范围
  • 完成定义 / 验证命令

编辑所有权:一次只能由一个角色编辑一组文件;仅评审的 architect 不会批量重写。

协调器检查清单

  1. orca status --json 就绪
  2. 脚手架已存在(roles.yaml + 脚本)或运行安装
  3. 句柄有效或已引导
  4. 根据 roles.yaml 路由
  5. 调度 --inject → 检查 --wait
  6. 限制 → 回退脚本
  7. 综合 worker_done 正文;如有必要重新调度修复

禁止行为

  • 当用户要求 Orca 角色编排时,用通用子代理替换 Orca 调度
  • 将 fallback 用作默认质量通道
  • 在其窗口重置之前重试受限的主要角色
  • 在监督工作后没有 task-list / dispatch-show 证据的情况下声称编排

相关

  • 通用 Orca 生命周期:技能 orchestration
  • 安装后的项目手册:.orca/orchestration/PLAYBOOK.md

相关技能