Orquestación de Roles para Orca
Configuración portátil de cuatro roles para Orca Agent IDE. El coordinador asigna trabajo según la fuerza del modelo; los trabajadores reportan worker_done bajo despacho supervisado.
Roles (fijos)
| Rol | Modelo | Lanzamiento |
|---|---|---|
| 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 |
Principio: Opus profundiza, Sol cierra, Grok amplía. Límite → agy Flash Medium.
Cargar references/model-roles.md solo cuando el usuario pregunte por qué se eligió un rol.
Precondiciones
orca status --json # runtime.reachable true
# Configuración → Experimental → Orquestación de agentes ACTIVADA
which orca claude codex grok agy
Si el proyecto no está en Orca: orca repo add --path <ruta-absoluta-del-proyecto>.
Estructura del skill
orca-role-orchestration/
SKILL.md
scripts/
install-to-project.sh # scaffold en cualquier repositorio
orca-bootstrap-roles.sh
orca-dispatch-role.sh
orca-fallback-on-limit.sh
templates/ # copiado al proyecto por install
references/model-roles.md
Resolver la raíz del skill desde el directorio de este archivo. Una instalación convencional es:
~/.agents/skills/orca-role-orchestration/
(Grok también puede ver ~/.grok/skills/orca-role-orchestration → enlace simbólico)
Los comandos de lanzamiento de trabajador por defecto omiten las comprobaciones de permisos del proveedor. Úselos solo en repositorios de confianza, o elimine las banderas de omisión antes del bootstrap.
Modos
A) Instalar scaffold en el proyecto actual (primera vez o nuevo repositorio)
SKILL=~/.agents/skills/orca-role-orchestration
"$SKILL/scripts/install-to-project.sh" --project-root "$(pwd)"
# opcional: --project-name mi-app --force
Crea:
.orca/orchestration/roles.yaml(SSOT).orca/orchestration/PLAYBOOK.md,SCRIPTS.md,handles.example.jsonscripts/orca-{bootstrap-roles,dispatch-role,fallback-on-limit}.sh- ignora
handles.json; añade una sección corta en AGENTS.md si existe AGENTS.md
Luego personalizar project_hints en roles.yaml y fusionar las restricciones de AGENTS.md en el enrutamiento.
B) Iniciar roles trabajadores
./scripts/orca-bootstrap-roles.sh --worktree path:$(pwd)
Escribe .orca/orchestration/handles.json. Vuelva a ejecutar después de pestañas cerradas / identificadores no válidos. Es posible que aparezcan pestañas duplicadas si aún hay pestañas role-* abiertas — ciérrelas primero cuando se necesite un estado limpio.
C) Enrutamiento + despacho supervisado
Use el ciclo de vida supervisado solo cuando el usuario quiera coordinar / supervisar / esperar / DAG / resultados:
- Leer
.orca/orchestration/roles.yamltabla de enrutamiento (y AGENTS.md). - Elegir rol principal (y secundario si hay ruta dual).
- Despachar:
./scripts/orca-dispatch-role.sh architect --spec "Solo plan: <objetivo>. Seguir AGENTS.md."
./scripts/orca-dispatch-role.sh executor --spec "Implementar plan aprobado: …"
./scripts/orca-dispatch-role.sh thrifty --spec "Mapa de solo lectura: …"
- Esperar con ventanas deslizantes (timeout ≠ fallo):
orca orchestration check --wait \
--types worker_done,escalation,decision_gate \
--timeout-ms 900000 --json
- En caso de límite de sesión/tasa:
./scripts/orca-fallback-on-limit.sh --from <rol|term_*> --spec "Continuar: <objetivo + parcial>"
D) Traspaso completo (sin ciclo de vida)
Si el usuario dice traspaso / 넘겨줘 sin lenguaje de supervisión: no cree/despache/verifique tareas. Use orca terminal send o traspaso de worktree sin ciclo de vida solamente. Consulte las reglas de propiedad del skill orchestration genérico.
Hoja de referencia de enrutamiento
| Necesidad del usuario | Rol |
|---|---|
| Diseño, ámbito ambiguo, revisión de alto riesgo | architect |
| Implementación difícil, depuración, typecheck/build, cerrar PR unitario | executor |
| Arreglo pequeño, mapear código, investigación, prototipo | thrifty |
| Límite de sesión/tasa/cuota del primario alcanzado | fallback |
DAG estándar: architect(plan) → executor|thrifty(impl) → architect(solo-revisión).
Escalera de costos: thrifty → executor → architect.
Higiene de especificaciones
Los scripts agregan automáticamente el prefijo [ROLE=<rol> | <modelo>]. El cuerpo debe incluir:
- Objetivo (una oración sobre el estado final)
- Restricciones (de AGENTS.md / barreras de producto)
- Ámbito de archivos permitidos
- Definición de completado / comandos de verificación
Propiedad de edición: un rol edita un conjunto de archivos a la vez; architect de solo revisión no reescribe en bloque.
Lista de verificación del coordinador
orca status --jsonlisto- Scaffold presente (
roles.yaml+ scripts) o ejecutar install - Identificadores válidos o bootstrap
- Enrutar según roles.yaml
- Despachar --inject → check --wait
- Límite → script fallback
- Sintetizar cuerpos de worker_done; re-despachar correcciones si es necesario
No hacer
- Sustituir subagentes genéricos por despacho de Orca cuando el usuario pidió orquestación de roles de Orca
- Usar fallback como carril de calidad predeterminado
- Reintentar un primario limitado hasta que su ventana se restablezca
- Reclamar orquestación sin prueba de
task-list/dispatch-showdespués de trabajo supervisado
Relacionado
- Ciclo de vida genérico de Orca: skill
orchestration - Playbook del proyecto después de instalar:
.orca/orchestration/PLAYBOOK.md