zeromountain/orca-role-orchestration

Orquestación de roles multi-modelo para el IDE Orca Agent.

¿Qué es orca-role-orchestration?

Este skill configura un sistema portátil de cuatro roles para el IDE Orca Agent. Un coordinador central asigna tareas según la capacidad del modelo y los trabajadores reportan `worker_done` bajo un esquema supervisado. Los roles fijos son: **architect** (Claude Opus 4.8 para diseño y revisión), **executor** (GPT-5.6 Sol para implementación pesada), **thrifty** (Grok 4.5 para tareas ligeras y exploración) y **fallback** (Gemini 3.5 Flash Medio para límites de cuota). El skill incluye scripts para instalar el scaffold en el proyecto, iniciar roles, despachar tareas con supervisión y manejar límites de sesión. Funciona en Orca Agent IDE y requiere que los binarios `orca`, `claude`, `codex`, `grok` y `agy` estén disponibles. Los usuarios deben seguir el checklist de coordinación para asegurar un flujo correcto: validar estado, router por tabla de roles, despachar, esperar resultados y usar fallback cuando sea necesario.

Compatible con✓Claude Code✓Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add zeromountain/orca-role-orchestration

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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)

RolModeloLanzamiento
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

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.json
  • scripts/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:

  1. Leer .orca/orchestration/roles.yaml tabla de enrutamiento (y AGENTS.md).
  2. Elegir rol principal (y secundario si hay ruta dual).
  3. 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: …"
  1. Esperar con ventanas deslizantes (timeout ≠ fallo):
orca orchestration check --wait \
  --types worker_done,escalation,decision_gate \
  --timeout-ms 900000 --json
  1. 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 usuarioRol
Diseño, ámbito ambiguo, revisión de alto riesgoarchitect
Implementación difícil, depuración, typecheck/build, cerrar PR unitarioexecutor
Arreglo pequeño, mapear código, investigación, prototipothrifty
Límite de sesión/tasa/cuota del primario alcanzadofallback

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

  1. orca status --json listo
  2. Scaffold presente (roles.yaml + scripts) o ejecutar install
  3. Identificadores válidos o bootstrap
  4. Enrutar según roles.yaml
  5. Despachar --inject → check --wait
  6. Límite → script fallback
  7. 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-show despué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

Skills relacionados