Orca 角色编排
适用于 Orca Agent IDE 的可移植四角色设置。协调器根据模型强度分配工作;工人在监督式调度下报告 worker_done。
角色(固定)
| 角色 | 模型 | 启动命令 |
|---|---|---|
| architect | Claude Opus 4.8 | claude --model claude-opus-4-8 --dangerously-skip-permissions |
| executor | GPT-5.6 Sol | codex --model gpt-5.6-sol -c model_reasoning_effort="high" --dangerously-bypass-approvals-and-sandbox |
| thrifty | Grok 4.5 | grok --model grok-4.5 --permission-mode bypassPermissions |
| fallback | Gemini 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.jsonscripts/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/结果时使用 监督式 生命周期:
- 读取
.orca/orchestration/roles.yaml的路由表(以及 AGENTS.md)。 - 选择主要角色(如果是双路径则选择次要角色)。
- 调度:
./scripts/orca-dispatch-role.sh architect --spec "仅规划:<目标>。遵循 AGENTS.md。"
./scripts/orca-dispatch-role.sh executor --spec "实施已批准的计划:…"
./scripts/orca-dispatch-role.sh thrifty --spec "只读映射:…"
- 使用滚动窗口等待(超时 ≠ 失败):
orca orchestration check --wait \
--types worker_done,escalation,decision_gate \
--timeout-ms 900000 --json
- 遇到速率/会话限制时:
./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 不会批量重写。
协调器检查清单
orca status --json就绪- 脚手架已存在(
roles.yaml+ 脚本)或运行安装 - 句柄有效或已引导
- 根据 roles.yaml 路由
- 调度 --inject → 检查 --wait
- 限制 → 回退脚本
- 综合 worker_done 正文;如有必要重新调度修复
禁止行为
- 当用户要求 Orca 角色编排时,用通用子代理替换 Orca 调度
- 将 fallback 用作默认质量通道
- 在其窗口重置之前重试受限的主要角色
- 在监督工作后没有
task-list/dispatch-show证据的情况下声称编排
相关
- 通用 Orca 生命周期:技能
orchestration - 安装后的项目手册:
.orca/orchestration/PLAYBOOK.md