orca-multiagent-kit 1.2.0 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AI_INSTALL.md +5 -2
- package/CHANGELOG.md +53 -1
- package/GUIA.html +34 -9
- package/README.md +13 -2
- package/VERSION +1 -1
- package/bin/omk.js +15 -9
- package/core/AGENTS.md +34 -31
- package/docs/CSR.md +95 -0
- package/docs/INSTALADOR-ORCA-WINDOWS.md +101 -0
- package/docs/MANUAL.md +15 -9
- package/docs/OLIMPO.md +409 -0
- package/docs/ORQUESTADOR.md +123 -0
- package/docs/PLUGIN-ORCA.md +103 -0
- package/install.sh +138 -20
- package/orca-plugin/.gitattributes +1 -0
- package/orca-plugin/README.md +12 -0
- package/orca-plugin/orca-plugin.json +80 -0
- package/orca-plugin/src/kit.test.ts +185 -0
- package/orca-plugin/src/kit.ts +141 -0
- package/orca-plugin/src/worker.test.ts +155 -0
- package/orca-plugin/src/worker.ts +182 -0
- package/orca-plugin/tsconfig.json +6 -0
- package/package.json +2 -2
- package/rules/00-router.md +2 -1
- package/rules/10-communication.md +11 -12
- package/rules/20-clean-code.md +7 -3
- package/rules/30-security.md +1 -1
- package/rules/31-security-audit.md +6 -2
- package/rules/32-ai-security.md +59 -0
- package/rules/40-testing.md +7 -0
- package/rules/50-done-gate.md +20 -17
- package/rules/60-git-workflow.md +1 -1
- package/rules/75-reliability.md +3 -3
- package/rules/80-supply-chain.md +18 -11
- package/rules/95-multi-agent.md +48 -19
- package/rules/lang/cpp.md +1 -1
- package/rules/lang/csharp.md +4 -4
- package/rules/lang/dart-flutter.md +1 -1
- package/rules/lang/infra.md +3 -4
- package/rules/lang/kotlin.md +1 -1
- package/rules/lang/php.md +1 -1
- package/rules/lang/shell.md +17 -1
- package/skills/csr-audit/SKILL.md +6 -5
- package/skills/csr-gate/SKILL.md +12 -8
- package/skills/csr-stack/SKILL.md +6 -3
- package/skills/kit-init/SKILL.md +4 -2
- package/skills/orca/SKILL.md +60 -24
- package/skills/orca/references/adapters/artifact.md +1 -1
- package/skills/orca/references/adapters/chat.md +1 -1
- package/skills/orca/references/adapters/native-plan.md +1 -1
- package/skills/orca/references/adapters/plan-file.md +1 -1
- package/skills/orca/references/adapters/speckit.md +3 -1
- package/skills/orca/references/engine-manual.md +10 -12
- package/skills/orca/references/engine-orca.md +69 -23
- package/skills/orca/references/engine-subagents.md +16 -4
- package/skills/orca/references/integrate.md +66 -15
- package/skills/orca/references/ledger.md +59 -0
- package/skills/orca/references/olimpo.md +92 -0
- package/skills/orca/references/race.md +1 -0
- package/skills/orca/references/setup.md +14 -7
- package/skills/orca/references/units.md +13 -1
- package/skills/orca/references/worker-contract.md +28 -11
- package/skills/speckit-orca-implement/SKILL.md +2 -0
- package/speckit-extension/orca/commands/implement.md +2 -0
- package/templates/.worktreeinclude +7 -3
- package/templates/ORCHESTRATION.md +31 -18
- package/templates/STACK.md +2 -2
- package/templates/models.md +29 -0
- package/templates/orca.yaml +10 -2
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
# Mejoras del orquestador (skill `orca` · MAW)
|
|
2
|
+
|
|
3
|
+
Este documento explica qué cambia en la orquestación multiagente, por qué, y cómo comprobarlo. Afecta a la skill `orca` y sus referencias, a `rules/95-multi-agent.md`, al hook de spec-kit y a la plantilla `ORCHESTRATION.md`.
|
|
4
|
+
|
|
5
|
+
**Tipo de cambio: MINOR.** Los contratos entre agentes (`units.md` y `worker-contract.md`) solo ganan campos **opcionales**; ningún nombre de campo cambia. Un worker o coordinador de la v1.1.0 sigue entendiendo los briefs e informes nuevos.
|
|
6
|
+
|
|
7
|
+
## Resumen
|
|
8
|
+
|
|
9
|
+
| # | Mejora | Ficheros |
|
|
10
|
+
|---|---|---|
|
|
11
|
+
| 1 | Reparto de papeles claro con la skill `orchestration` de Orca | `skills/orca/SKILL.md`, `references/engine-orca.md` |
|
|
12
|
+
| 2 | Motor Orca alineado con el CLI real (1.4.252): sin polling, DAG de tareas, gates, recuperación | `references/engine-orca.md` |
|
|
13
|
+
| 3 | Runs reanudables: estado del run en `.work/runs/<run>/run.md` | `references/ledger.md` (nuevo), `SKILL.md`, motores, adaptador spec-kit, hook |
|
|
14
|
+
| 4 | «¿Compensa?» con una cuenta, presupuestos por talla y límite de reintentos | `rules/95-multi-agent.md`, `SKILL.md`, plantilla |
|
|
15
|
+
| 5 | Integración más segura: alcance comprobado con git, ensayo de merge, revisión cruzada, revert de una unidad | `references/integrate.md` |
|
|
16
|
+
| 6 | Informe del worker verificable y autocomprobación de alcance | `references/worker-contract.md` |
|
|
17
|
+
| 7 | Confianza entre agentes: informes como entrada no confiable, sin secretos en briefs | `rules/95-multi-agent.md`, contrato, `units.md` |
|
|
18
|
+
| 8 | Coherencia entre motores y con spec-kit | motores, adaptadores, hook, test |
|
|
19
|
+
|
|
20
|
+
## 1. `orca` y `orchestration`: quién manda en qué
|
|
21
|
+
|
|
22
|
+
**Antes.** Las dos descriptions se solapaban («paralelo», «workers», «Orca»). Con las dos skills instaladas, el agente podía cargar la de Orca y lanzar workers sin el plan de rondas, sin `write`/`shared` y sin la integración del kit.
|
|
23
|
+
|
|
24
|
+
**Ahora.**
|
|
25
|
+
- La description de `orca` dice que es la **política** del kit (reparto, rondas, integración, reanudación) y que para la sintaxis de Orca se carga además `orchestration`.
|
|
26
|
+
- Para delegar una tarea suelta sin plan ni integración («que Codex revise esto»), la description remite a `orchestration`/`orca-cli`, que es lo que encaja.
|
|
27
|
+
- `engine-orca.md` lo deja escrito: en comandos y flags gana la guía de Orca; en alcance, merges y confirmaciones gana el kit.
|
|
28
|
+
|
|
29
|
+
## 2. Motor Orca alineado con el CLI real
|
|
30
|
+
|
|
31
|
+
Comprobado contra `orca skills get orchestration` y el `--help` de cada subcomando en Orca 1.4.252.
|
|
32
|
+
|
|
33
|
+
| Antes | Ahora | Por qué |
|
|
34
|
+
|---|---|---|
|
|
35
|
+
| Bucle `orca orchestration check --wait … --timeout-ms 900000` y `--ack` | Lanzar la ronda y **terminar el turno**; Orca despierta al coordinador. Nada de scripts con `check` | La guía actual lo prohíbe: un `check` consumido por un script es correo que el agente no ve. `--ack` ya no hace falta |
|
|
36
|
+
| `task-create --spec "<mensaje>"` | `task-create --spec-file .work/runs/<run>/briefs/<u>.md --deps '[…]'` | Sin problemas de comillas en briefs largos (PowerShell y bash). `--deps` monta el DAG con los `depends_on` de las unidades, y el plan entero queda visible en Orca |
|
|
37
|
+
| `worker-start --worktree new-child` sin base | `worker-start --worktree new-child --base-branch <rama de integración>` | Garantiza que cada worker parte del commit base de la ronda |
|
|
38
|
+
| Rama supuesta `maw/<run>/<unit>` | La rama se lee del recibo o de `orca worktree show` | La nombra Orca |
|
|
39
|
+
| Decisiones de producto solo en el chat | `gate-create` / `gate-resolve` sobre la tarea afectada | La decisión pendiente se ve en Orca y bloquea solo esa tarea |
|
|
40
|
+
| Reintento genérico | `worker-start --task <id> --retry-of <dispatch>` repitiendo `--worktree` y `--agent`; respeto del circuit breaker (3 arranques fallidos) | Así lo exige Orca; esquivarlo con otro Run o Task lo prohíbe su guía |
|
|
41
|
+
| Sin criterio para parar workers | `worker-stop`/`worker-abandon` solo con orden explícita del usuario; `stop_unknown` ⇒ `worker-show` | Silencio o timeout no prueban que un worker haya terminado |
|
|
42
|
+
| `worker-release` como única limpieza | `worker-release` tras integrar (los `new-child` se quedan abiertos), `worktree rm` tras el merge final, nunca `reset` | Comportamiento documentado de Orca: liberación automática solo en `current` |
|
|
43
|
+
| Vigilancia sin herramientas | `worktree ps`, `worker-list --run`, `worker-show` (`observation.agentWait`: el worker espera a un humano) | Detecta workers parados en un prompt de permisos |
|
|
44
|
+
| Con Orca, el brief solo llevaba §2 del contrato | Lleva §2, §4 y §5 | Sin §5 el `--body` de `worker_done` no tenía formato fijo y el coordinador no podía verificarlo |
|
|
45
|
+
|
|
46
|
+
## 3. Runs reanudables
|
|
47
|
+
|
|
48
|
+
**Antes.** El estado del run vivía en la conversación del coordinador. Si el contexto se compactaba, el agente se cerraba u Orca caía, no había forma fiable de saber qué unidad estaba lanzada, integrada o pendiente, y el riesgo era relanzar trabajo o perderlo.
|
|
49
|
+
|
|
50
|
+
**Ahora.** `references/ledger.md` define `.work/runs/<run>/run.md`, que escribe solo el coordinador:
|
|
51
|
+
- Cabecera del run (entrada, motor, id del Run de Orca, autonomía, rama de integración, estado) y una tabla por unidad (`status`, `ref` del motor, rama, base, head, intentos).
|
|
52
|
+
- **Se escribe antes de actuar**: `dispatching` antes de lanzar y `dispatched` con el id después. Una caída entre los dos pasos no acaba en doble lanzamiento.
|
|
53
|
+
- Procedimiento de reanudación por motor: con Orca, `run-use`, `task-list`, `worker-list` e `inbox` (para procesar un `worker_done` que llegó mientras el coordinador no estaba); con subagentes y manual, la rama y el worktree son la verdad.
|
|
54
|
+
- Se puede pasar lo pendiente a otro motor si uno cae, sin dejar dos intentos vivos de la misma unidad.
|
|
55
|
+
- La skill detecta un run activo al empezar y lo reanuda en vez de planificar de nuevo. El hook de spec-kit también, y añade la salida `ORCA: pendiente — …` para que `/speckit.implement` no haga por su cuenta tareas que siguen abiertas en un worker.
|
|
56
|
+
|
|
57
|
+
## 4. «¿Compensa?» más preciso
|
|
58
|
+
|
|
59
|
+
**Antes.** Cuatro condiciones cualitativas (≥2 unidades, `write` disjuntos, ≥15 min, verificables).
|
|
60
|
+
|
|
61
|
+
**Ahora** (`rules/95-multi-agent.md`), además:
|
|
62
|
+
- **Cuenta rápida**: ahorro por ronda (`Σ t − max t`) contra un coste de coordinación de 10 min por unidad y 10 min por ronda, con penalización por cada fichero `shared` que obligue a serializar. En caso de duda, secuencial.
|
|
63
|
+
- **Presupuesto por talla** (S ≤15 min, M 20–60 min, L dividir) y campo opcional `budget` en la unidad. «Atascado» se define: sin progreso durante el doble del presupuesto.
|
|
64
|
+
- **Reintentos**: como mucho uno automático por unidad, mismo agente si falló el entorno y otro proveedor si falló el razonamiento; después `BLOCKED`.
|
|
65
|
+
- **Ficheros generados** (clientes de API, tipos de BD, lockfiles): no van en el `write` de ninguna unidad; los regenera el coordinador tras integrar.
|
|
66
|
+
- La plantilla `ORCHESTRATION.md` gana tres líneas: revisión cruzada, reintentos y presupuesto.
|
|
67
|
+
|
|
68
|
+
## 5. Integración más segura
|
|
69
|
+
|
|
70
|
+
| Antes | Ahora |
|
|
71
|
+
|---|---|
|
|
72
|
+
| «Ficheros ⊆ `write`», revisado a ojo | `git diff --name-only <base>...<rama>` contra `write`, y contraste de tres listas: git, `files:` del informe y `--files-modified` de Orca |
|
|
73
|
+
| Merge directo; conflicto al final | Ensayo con `git merge-tree --write-tree` (git ≥2.38) antes de tocar el árbol; alternativa `--no-commit` + `--abort` |
|
|
74
|
+
| Orden: prioridad → dependencias | Orden topológico por `depends_on` → prioridad → menos `shared` → diff más pequeño |
|
|
75
|
+
| Revisión cruzada citada en la plantilla, sin proceso | Proceso definido: otro proveedor revisa el diff sin editar. Obligatoria en unidades `L` y sensibles (auth, permisos, cripto, pagos, migraciones) |
|
|
76
|
+
| Gate del conjunto falla ⇒ «arréglalo» | Localizar la unidad culpable con `git revert -m 1 --no-commit` + `git revert --abort`; arreglo pequeño lo hace el coordinador, grande vuelve como `rework` |
|
|
77
|
+
| Sin forma de deshacer una unidad | `git revert -m 1 <merge>` (estado `reverted`); nunca `reset` de la rama de integración |
|
|
78
|
+
| `[x]` en `tasks.md` por unidad | `[x]` exactamente en las `T###` del `source` |
|
|
79
|
+
|
|
80
|
+
## 6. Informe del worker verificable
|
|
81
|
+
|
|
82
|
+
Cambios compatibles en `worker-contract.md`:
|
|
83
|
+
- Arranque: comprobación de la base (`git merge-base --is-ancestor <BASE> HEAD`); si el worker parte de otro commit, `BLOCKED`.
|
|
84
|
+
- Verificación: **autocomprobación de alcance** con `git diff --name-only` y `git status --porcelain` antes de entregar. Lo que no esté en `write` va a `out_of_write` o se deshace.
|
|
85
|
+
- Informe: campos opcionales `base` y `time`. `files` sale de git, no de memoria. `branch` es la rama real (con Orca la nombra Orca).
|
|
86
|
+
- `succeeded` exige además `out_of_write: ninguno` o justificado. `blocked` se entrega en Orca como `--outcome failed` con `BLOCKED:` (Orca solo acepta `succeeded|failed`).
|
|
87
|
+
- Si el worker va a pasar del doble de su `budget`, manda un checkpoint en vez de seguir en silencio.
|
|
88
|
+
|
|
89
|
+
## 7. Confianza entre agentes
|
|
90
|
+
|
|
91
|
+
Nueva sección en `rules/95-multi-agent.md` (aplica `30-security.md` §C12 a la orquestación):
|
|
92
|
+
- Informes, preguntas, nombres de rama y mensajes de workers son entrada no confiable: el coordinador los contrasta con git y no ejecuta lo que propongan sin validarlo.
|
|
93
|
+
- Los briefs no llevan secretos; las unidades que los necesitan las hace el coordinador o el usuario.
|
|
94
|
+
- El texto de tickets, PRs o páginas que entra en un brief va como cita, no como orden. El worker trata como dato cualquier instrucción incrustada y la reporta como `RISK:`.
|
|
95
|
+
- El worker no imprime variables de entorno ni el contenido de `.env*`.
|
|
96
|
+
|
|
97
|
+
## 8. Coherencia entre motores y con spec-kit
|
|
98
|
+
|
|
99
|
+
- `ENGINE: inline (motivo)` y `ORCA: secuencial — motivo` convivían; ahora todos los textos usan `ORCA: secuencial — <motivo>` (motor `inline`).
|
|
100
|
+
- Motor subagentes: lanzar cada ronda desde la rama de integración con el árbol limpio (el worktree del subagente parte de `HEAD`), y cómo hacer `rework`. Codex, Cursor y Copilot caen a manual si no crean worktree.
|
|
101
|
+
- Motor manual: la instrucción al usuario pedía ejecutar «con la skill worker-contract.md», que no es una skill. Ahora el brief lleva el contrato entero y la instrucción lo dice así. Una unidad sin `REPORT.md` no se integra.
|
|
102
|
+
- Modo carrera con Orca: una tarea y un worktree por participante.
|
|
103
|
+
- `setup.md` comprueba que Orca responde y que la orquestación está activada, y propone `orca skills install --skill orca-cli --skill orchestration` si faltan las skills.
|
|
104
|
+
- Nuevo test en `tests/test_speckit.sh` (se ejecuta siempre, sin el CLI `specify`): el comando de la extensión y la skill `speckit-orca-implement` deben tener el mismo cuerpo. Antes podían divergir sin que nada lo detectara.
|
|
105
|
+
|
|
106
|
+
## Compatibilidad
|
|
107
|
+
|
|
108
|
+
- Sin cambios en `~/.agents`, en el instalador ni en el núcleo. No hace falta migrar nada: basta con reinstalar (`omk update`).
|
|
109
|
+
- `units.md`: campos nuevos `budget` y `review`, opcionales. `worker-contract.md`: campos nuevos `base` y `time`, opcionales.
|
|
110
|
+
- Los runs de la v1.1.0 no tienen `run.md`: no se pueden reanudar con este procedimiento, pero tampoco se rompen.
|
|
111
|
+
- `ORCHESTRATION.md` existentes siguen valiendo; las tres líneas nuevas toman su valor por defecto si faltan.
|
|
112
|
+
|
|
113
|
+
## Cómo probarlo
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
bash scripts/check.sh # frontmatter, longitud de descriptions, rutas neutrales
|
|
117
|
+
bash tests/test_speckit.sh # cuerpo del hook = skill; con specify ≥1.0, instalación real de la extensión
|
|
118
|
+
```
|
|
119
|
+
A mano, en un proyecto con Orca:
|
|
120
|
+
1. «Implementa U1 y U2 en paralelo» con dos partes independientes: el plan de rondas aparece y, tras el «sí», existe `.work/runs/<run>/run.md`.
|
|
121
|
+
2. Las tareas se ven en Orca con sus dependencias; el coordinador termina el turno tras lanzar la ronda y Orca lo despierta con cada `worker_done`.
|
|
122
|
+
3. Cierra el agente coordinador a mitad de ronda, ábrelo de nuevo y di «sigue el run»: debe responder `ORCA: reanudado run …` sin relanzar las unidades en curso.
|
|
123
|
+
4. Haz que un worker toque un fichero fuera de su `write`: la integración lo marca como `rework`.
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# Plugin de Orca
|
|
2
|
+
|
|
3
|
+
El kit funciona en [Orca](https://www.onorca.dev) sin plugin: las skills viven en `~/.agents/skills` (el mismo sitio donde Orca instala las suyas) y la skill `orca` usa `orca orchestration` como motor. El plugin `orca-plugin/` añade lo que solo puede hacer la propia app: comandos en la paleta, un cambio en los despachos de orquestación y un indicador en la barra de estado.
|
|
4
|
+
|
|
5
|
+
Requisitos: Orca ≥ 1.4.248 (hooks y barra de estado) con los plugins activados (*Settings → Plugins → Turn on plugins*). Para los comandos, el kit instalado (`omk` en el `PATH`).
|
|
6
|
+
|
|
7
|
+
## Qué hace
|
|
8
|
+
|
|
9
|
+
| Pieza | Qué ves | Cómo funciona |
|
|
10
|
+
|---|---|---|
|
|
11
|
+
| **Orca Multiagent Kit: verificar instalación** | Un terminal nuevo en el workspace activo que ejecuta `omk verify` | `terminal.create` con el literal `omk verify` |
|
|
12
|
+
| **Orca Multiagent Kit: actualizar kit** | Lo mismo con `omk update` | `terminal.create` con el literal `omk update` |
|
|
13
|
+
| **Orca Multiagent Kit: inicializar proyecto** | Un agente nuevo en el workspace activo con el prompt «inicializa el proyecto» (skill `kit-init`) | `agent.launch`; el agente sale del ajuste *Agente para inicializar* (por defecto `claude`) |
|
|
14
|
+
| **Orca Multiagent Kit: estado de los agentes** | Una línea por agente activo: título y estado | Lo que ha ido contando la barra de estado |
|
|
15
|
+
| **Contrato del worker** | Cada despacho de la skill `orca` lleva al final una línea que remite a `~/.agents/skills/orca/references/worker-contract.md` | Hook `agent.prompt.before` |
|
|
16
|
+
| **Barra de estado** `MAW · 2 trabajando · 1 bloqueado` | Agentes trabajando, bloqueados o esperando en todos los workspaces. Ámbar si hay alguno bloqueado. Al pulsarlo, el estado de los agentes | Evento `agent.status.changed` y `agents.list` al arrancar |
|
|
17
|
+
|
|
18
|
+
Si `omk` no está en el `PATH`, el terminal muestra el error del shell y, en unos 15 s, llega una notificación con cómo instalarlo (`npm install -g orca-multiagent-kit` o `./install.sh`). Si el plugin no identifica el workspace activo (ninguno enfocado, o dos con el mismo nombre y rama), avisa y no ejecuta nada: es preferible no lanzar nada a lanzarlo en otro workspace.
|
|
19
|
+
|
|
20
|
+
### Por qué el contrato del worker
|
|
21
|
+
|
|
22
|
+
Con el motor Orca, la skill `orca` copia en el despacho solo parte del contrato (entorno §1.4, alcance §2, verificación §4 e informe §5), porque Orca ya le explica al worker cómo preguntar y cómo cerrar con `worker_done`. El hook añade una línea que remite al fichero completo, para que el worker tenga también el arranque y la implementación. Para eso:
|
|
23
|
+
|
|
24
|
+
- Solo actúa sobre prompts que Orca marca como despacho de orquestación (`inputKind: "orchestration"`). Nunca toca lo que escribes tú, los prompts de arranque de un agente ni `orca terminal send`.
|
|
25
|
+
- En el modo por defecto (*Solo despachos del kit*), además, el despacho tiene que llevar la cabecera de la skill `orca` (`UNIT: U<n> …` al principio de una línea y `RUN: …`). Las líneas `ROL:` y `SETUP:` que la skill añade desde la 1.4.0 no cambian esa detección. Los despachos de otros coordinadores pasan intactos. *Todos los despachos* lo añade a cualquiera; *Desactivado* lo apaga.
|
|
26
|
+
- Si el prompt ya cita `worker-contract.md`, no lo repite.
|
|
27
|
+
- **No deniega nunca** y falla en abierto (`"onError": "pass"`): si el worker del plugin falla o tarda más de 2 s, Orca envía el prompt sin cambios. Es una ayuda para el worker, no un control de seguridad.
|
|
28
|
+
|
|
29
|
+
## Permisos que pide
|
|
30
|
+
|
|
31
|
+
Es un plugin `trusted-worker`: Orca ejecuta `src/worker.ts` en un proceso Node aparte, con el acceso de tu usuario a la máquina. Por eso pide aprobación al instalarlo. Las capacidades, y para qué se usa cada una:
|
|
32
|
+
|
|
33
|
+
| Capacidad | Para qué | Si no la concedes |
|
|
34
|
+
|---|---|---|
|
|
35
|
+
| `workspace:read` | Saber qué workspace está enfocado (`workspace.readContext` + `workspace.list`) y enterarse de los que se eliminan | Los comandos no saben dónde ejecutarse |
|
|
36
|
+
| `terminal:send` | Abrir un terminal con `omk verify` / `omk update` (`terminal.create`) | No hay comandos de verificar ni actualizar |
|
|
37
|
+
| `terminal:read` | Leer la salida de **ese** terminal para detectar que `omk` no existe y avisar | El fallo se ve en el terminal, pero no llega la notificación |
|
|
38
|
+
| `agent:launch` | Lanzar el agente de «inicializar proyecto» (`agent.launch`) | No hay comando de inicializar |
|
|
39
|
+
| `agent:read` | Contar agentes por estado para la barra (`agents.list`, `agent.status.changed`) | La barra se queda en `MAW` |
|
|
40
|
+
| `notifications:show` | Avisos accionables (sin `omk`, sin workspace, fallos de Orca) | Los avisos solo quedan en `orca plugin logs` |
|
|
41
|
+
| `settings:own` | Leer los tres ajustes del plugin | Se usan los valores por defecto |
|
|
42
|
+
|
|
43
|
+
Lo que **no** hace: no envía al terminal texto que venga de un usuario, de un agente o de un fichero (los dos comandos son literales fijos). El id de agente del ajuste se valida (`^[a-z0-9][a-z0-9-]{0,39}$`) antes de pasarlo a `agent.launch`. No usa red, secretos ni almacenamiento, no lee ficheros del proyecto y no importa módulos de Node (`fs`, `child_process`…): todo pasa por la API de Orca y sus capacidades.
|
|
44
|
+
|
|
45
|
+
## Instalar
|
|
46
|
+
|
|
47
|
+
El manifiesto está en `orca-plugin/`, no en la raíz del repo, así que se instala desde una carpeta (ver *Limitaciones*). Elige la que tengas:
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
# Desde un clon o el zip de la release
|
|
51
|
+
orca plugin install ./orca-plugin --json
|
|
52
|
+
|
|
53
|
+
# Con el kit instalado por npm (npm i -g orca-multiagent-kit)
|
|
54
|
+
orca plugin install "$(npm root -g)/orca-multiagent-kit/orca-plugin" --json
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
La primera vez termina con `approval_required` (código de salida 3). `error.data` lista lo que concedería (la tabla de arriba) y el comando exacto para repetirlo con `--approve <fingerprint>`. Revísalo y, si estás de acuerdo, ejecuta ese comando tal cual. La huella está ligada a esta versión, sus ficheros y su acceso: si una versión nueva pide algo más, Orca vuelve a preguntar. El plugin queda como `local.multiagent-kit`.
|
|
58
|
+
|
|
59
|
+
Ajustes en *Settings → Plugins → Orca Multiagent Kit*:
|
|
60
|
+
|
|
61
|
+
| Ajuste | Por defecto | Valores |
|
|
62
|
+
|---|---|---|
|
|
63
|
+
| Contrato del worker en los despachos | Solo despachos del kit | Solo del kit · Todos · Desactivado |
|
|
64
|
+
| Agentes en la barra de estado | Activado | sí / no |
|
|
65
|
+
| Agente para inicializar | `claude` | Id de agente de Orca (`claude`, `codex`…) |
|
|
66
|
+
|
|
67
|
+
## Desactivar o quitar
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
orca plugin disable local.multiagent-kit --json # deja de ejecutarse; se reactiva con enable
|
|
71
|
+
orca plugin uninstall local.multiagent-kit --json # lo quita
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Sin plugin, el kit sigue funcionando igual. Solo se pierden la paleta, la barra y la línea del contrato en los despachos.
|
|
75
|
+
|
|
76
|
+
## Limitaciones
|
|
77
|
+
|
|
78
|
+
- **Barra de estado**: al arrancar solo conoce los agentes del workspace enfocado (`agents.list` no da más); los de los demás aparecen con su siguiente cambio de estado. Un agente cuyo terminal se cierra sin pasar a `done` sigue contando hasta que se elimina su workspace o se reinicia el plugin (`orca plugin restart local.multiagent-kit`).
|
|
79
|
+
- **Detección de `omk` ausente**: es heurística. Busca durante ~15 s el mensaje de "comando no encontrado" de bash, zsh, fish, cmd y PowerShell, en inglés y español. Con otros idiomas o shells, el error se ve en el terminal pero no llega la notificación.
|
|
80
|
+
- En un workspace remoto (SSH), `omk` se ejecuta en ese host, que es donde se usa el kit en ese workspace.
|
|
81
|
+
|
|
82
|
+
DEFERRED:
|
|
83
|
+
- **Progreso del run en la barra** (`ronda 1 · 2/3 unidades`): exige leer `.work/runs/<run>/units.md`, y la API de Orca no da acceso a ficheros a los workers. Hoy el coordinador lo deja en el comentario del worktree (`orca worktree set --comment`).
|
|
84
|
+
- **Instalación desde Git** (`orca plugin install FernandoBaqueroo/orca-multiagent-kit`): la ayuda de `orca plugin install` (1.4.252) no documenta instalar desde una subcarpeta del repositorio. Haría falta un repo propio para el plugin o confirmar que Orca acepta una URL `tree/<ref>/orca-plugin`.
|
|
85
|
+
- **Instalación automática** con `install.sh` / `omk install`: ahora se instala a mano. Para hacerlo automático hay que tocar el instalador, y se deja para otro PR.
|
|
86
|
+
- **Preparar worktrees nuevos** (`workspace.create.after`): ya lo hacen `orca.yaml` (`scripts.setup`, `sharedDirectories`), `.worktreeinclude` y `worker-start --setup run`, que la skill pasa siempre; un hook duplicaría ese trabajo.
|
|
87
|
+
- **Rol y modelo en la barra de estado**: la barra cuenta agentes por estado, pero no sabe qué rol de Olimpo ni qué nivel de modelo tiene cada uno; eso está en `.work/runs/<run>/run.md`, que el plugin no puede leer.
|
|
88
|
+
|
|
89
|
+
## Probarlo
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
orca plugin validate orca-plugin --json # manifiesto como lo carga Orca
|
|
93
|
+
orca plugin test orca-plugin --json # 38 pruebas: src/kit.test.ts y src/worker.test.ts
|
|
94
|
+
orca plugin check orca-plugin --json
|
|
95
|
+
orca plugin inspect orca-plugin --json # qué aporta y qué acceso pide
|
|
96
|
+
bash scripts/check.sh # comprobación estática del manifiesto, también en CI (sin Orca)
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
Las pruebas usan `orca/testing`: `mountWorker` sobre un host simulado con las capacidades del manifiesto. Cubren el hook (con y sin cabecera del kit, otros `inputKind`, el modo apagado e idempotencia), los comandos (literal enviado, workspace sin identificar, fallo de Orca notificado, id de agente hostil) y la barra (eventos, siembra inicial, desactivada). La detección de `omk` ausente se prueba con los mensajes reales de cada shell.
|
|
100
|
+
|
|
101
|
+
Para probarlo en Orca sin instalarlo: `orca plugin dev watch orca-plugin --json`. También pide aprobación, y `Ctrl-C` lo descarga.
|
|
102
|
+
|
|
103
|
+
RISK: con Orca 1.4.252, `orca plugin test` falla al importar `orca-runtime.mjs` cuando la ruta del plugin contiene una carpeta que empieza por punto (por ejemplo `.claude/worktrees/…`). Si te pasa, copia `orca-plugin/` a una ruta sin carpetas ocultas y ejecútalo allí.
|
package/install.sh
CHANGED
|
@@ -12,10 +12,33 @@
|
|
|
12
12
|
set -Eeuo pipefail
|
|
13
13
|
|
|
14
14
|
SRC="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
15
|
+
|
|
16
|
+
# Ruta en formato Windows (C:\..., la que inyectan Orca o PowerShell) -> formato POSIX de este bash.
|
|
17
|
+
to_posix() { # $1 ruta -> stdout
|
|
18
|
+
case "$1" in
|
|
19
|
+
[A-Za-z]:[\\/]*|[A-Za-z]:|*\\*) ;;
|
|
20
|
+
*) printf '%s' "$1"; return 0 ;;
|
|
21
|
+
esac
|
|
22
|
+
if command -v cygpath >/dev/null 2>&1; then cygpath -u "$1"; return 0; fi
|
|
23
|
+
if command -v wslpath >/dev/null 2>&1; then wslpath -u "$1"; return 0; fi
|
|
24
|
+
local p d
|
|
25
|
+
p="$(printf '%s' "$1" | tr '\\' '/')"
|
|
26
|
+
case "$p" in [A-Za-z]:*) d="$(printf '%s' "${p%%:*}" | tr '[:upper:]' '[:lower:]')"; p="/$d/${p#?:}"; p="$(printf '%s' "$p" | tr -s '/')" ;; esac
|
|
27
|
+
printf '%s' "${p%/}"
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
# En Git Bash/MSYS/Cygwin, ln -s COPIA por defecto: una copia rompe la fuente única sin avisar.
|
|
31
|
+
# nativestrict crea un enlace nativo de Windows o falla (y entonces lo decimos).
|
|
32
|
+
case "$(uname -s 2>/dev/null)" in
|
|
33
|
+
MINGW*|MSYS*) export MSYS="${MSYS:+$MSYS }winsymlinks:nativestrict"; WINLINKS=1 ;;
|
|
34
|
+
CYGWIN*) export CYGWIN="${CYGWIN:+$CYGWIN }winsymlinks:nativestrict"; WINLINKS=1 ;;
|
|
35
|
+
*) WINLINKS=0 ;;
|
|
36
|
+
esac
|
|
37
|
+
|
|
38
|
+
AG="$(to_posix "${AGENT_KIT_HOME:-$HOME/.agents}")"
|
|
39
|
+
CLAUDE_DIR="$(to_posix "${CLAUDE_CONFIG_DIR:-$HOME/.claude}")"
|
|
40
|
+
GEMINI_DIR="$(to_posix "${GEMINI_DIR:-$HOME/.gemini}")"
|
|
41
|
+
CODEX_DIR="$(to_posix "${CODEX_HOME:-$HOME/.codex}")"
|
|
19
42
|
COPILOT_DIR="$HOME/.copilot"
|
|
20
43
|
CURSOR_DIR="$HOME/.cursor"
|
|
21
44
|
DEVIN_DIR="$HOME/.config/devin"
|
|
@@ -32,13 +55,13 @@ OLD_LANGS="cpp csharp dart-flutter go infra java kotlin php python react ruby ru
|
|
|
32
55
|
PROJECT=""; PROJECT_ONLY=0; VERIFY=0; DRY=0; AGENTS=""; RESTORE=""; ADOPT=""
|
|
33
56
|
while [ $# -gt 0 ]; do
|
|
34
57
|
case "$1" in
|
|
35
|
-
--project) PROJECT="${2:-}"; shift 2 ;;
|
|
36
|
-
--project-only) PROJECT="${2:-}"; PROJECT_ONLY=1; shift 2 ;;
|
|
58
|
+
--project) PROJECT="$(to_posix "${2:-}")"; shift 2 ;;
|
|
59
|
+
--project-only) PROJECT="$(to_posix "${2:-}")"; PROJECT_ONLY=1; shift 2 ;;
|
|
37
60
|
--agents) AGENTS="${2:-}"; shift 2 ;;
|
|
38
61
|
--verify) VERIFY=1; shift ;;
|
|
39
62
|
--dry-run) DRY=1; shift ;;
|
|
40
63
|
--restore) RESTORE="${2:-}"; shift 2 ;;
|
|
41
|
-
--adopt) ADOPT="${2:-}"; shift 2 ;;
|
|
64
|
+
--adopt) ADOPT="$(to_posix "${2:-}")"; shift 2 ;;
|
|
42
65
|
-h|--help) sed -n '2,12p' "$0"; exit 0 ;;
|
|
43
66
|
*) echo "Opcion desconocida: $1" >&2; exit 2 ;;
|
|
44
67
|
esac
|
|
@@ -94,11 +117,19 @@ agent_names() { local o="" a; for a in $(printf '%s' "$AGENTS" | tr ',' ' '); do
|
|
|
94
117
|
o="${o:+$o · }$a"; done; printf '%s' "$o"; }
|
|
95
118
|
has_agent() { case ",$AGENTS," in *",$1,"*) return 0 ;; *) return 1 ;; esac; }
|
|
96
119
|
|
|
97
|
-
#
|
|
120
|
+
# Ruta dentro del backup: relativa a $HOME si cuelga de el; si no, bajo _abs/ con su ruta absoluta (--restore la deshace).
|
|
121
|
+
backup_rel() { # $1 ruta absoluta -> stdout
|
|
122
|
+
case "$1" in
|
|
123
|
+
"$HOME"/*) printf '%s' "${1#"$HOME"/}" ;;
|
|
124
|
+
/*) printf '_abs%s' "$1" ;;
|
|
125
|
+
*) echo "Ruta no absoluta, no se puede respaldar: $1" >&2; return 1 ;;
|
|
126
|
+
esac
|
|
127
|
+
}
|
|
128
|
+
# Mueve una ruta al backup.
|
|
98
129
|
stash() {
|
|
99
130
|
local p="$1" rel
|
|
100
131
|
[ -e "$p" ] || [ -L "$p" ] || return 0
|
|
101
|
-
rel="$
|
|
132
|
+
rel="$(backup_rel "$p")"
|
|
102
133
|
run mkdir -p "$BK/$(dirname "$rel")"
|
|
103
134
|
run mv "$p" "$BK/$rel"
|
|
104
135
|
MOVED=$((MOVED+1))
|
|
@@ -107,17 +138,28 @@ stash() {
|
|
|
107
138
|
snapshot() {
|
|
108
139
|
local p="$1" rel
|
|
109
140
|
[ -e "$p" ] || return 0
|
|
110
|
-
rel="$
|
|
141
|
+
rel="$(backup_rel "$p")"
|
|
111
142
|
run mkdir -p "$BK/$(dirname "$rel")"
|
|
112
143
|
run cp -a "$p" "$BK/$rel"
|
|
113
144
|
}
|
|
145
|
+
LINK_HELP="En Windows, activa el Modo de desarrollador (Configuracion > Sistema > Para programadores) o abre Git Bash como administrador, y repite. Lo ya movido esta en el backup: ./install.sh --restore $STAMP"
|
|
114
146
|
# Deja $2 como enlace simbolico a $1. Si habia otra cosa, va al backup.
|
|
115
147
|
link() {
|
|
116
148
|
local target="$1" l="$2"
|
|
117
149
|
if [ -L "$l" ] && [ "$(readlink "$l")" = "$target" ]; then return 0; fi
|
|
118
150
|
stash "$l"
|
|
119
151
|
run mkdir -p "$(dirname "$l")"
|
|
120
|
-
run ln -s "$target" "$l"
|
|
152
|
+
run ln -s "$target" "$l" || { echo "No se pudo crear el enlace $l -> $target. $LINK_HELP" >&2; exit 1; }
|
|
153
|
+
}
|
|
154
|
+
# Antes de tocar nada: en Windows, comprueba que se pueden crear enlaces nativos.
|
|
155
|
+
check_links() {
|
|
156
|
+
[ "$WINLINKS" -eq 1 ] || return 0
|
|
157
|
+
local t; t="$(mktemp -d)"
|
|
158
|
+
mkdir "$t/destino"
|
|
159
|
+
if ln -s "$t/destino" "$t/enlace" 2>/dev/null && [ -L "$t/enlace" ]; then rm -rf "$t"; return 0; fi
|
|
160
|
+
rm -rf "$t"
|
|
161
|
+
echo "Este Windows no deja crear enlaces simbolicos, y el kit no instala copias (acabarian divergiendo). ${LINK_HELP%% Lo ya movido*}" >&2
|
|
162
|
+
exit 1
|
|
121
163
|
}
|
|
122
164
|
# Quita los bloques gestionados (CSR, MAW, AGENTS) de un fichero, conservando el resto.
|
|
123
165
|
strip_blocks() { # $1 fichero -> stdout
|
|
@@ -134,12 +176,58 @@ extract_overrides() { # $1 fichero -> stdout
|
|
|
134
176
|
inb && /^## Overrides de este proyecto/ {ov=1; next}
|
|
135
177
|
inb && ov && !/^<!--/ && !/^-[[:space:]]*$/ && NF>0 {print}' "$1"
|
|
136
178
|
}
|
|
179
|
+
# Un .env con señales de produccion no se copia a los worktrees: ahi los agentes trabajan sin confirmacion.
|
|
180
|
+
# Solo se mira si hay coincidencia (grep -q): el contenido no se lee ni se muestra.
|
|
181
|
+
PROD_MARK='^[[:space:]]*(export[[:space:]]+)?(NODE_ENV|APP_ENV|RAILS_ENV|DJANGO_ENV|FLASK_ENV|ENVIRONMENT|ASPNETCORE_ENVIRONMENT)[[:space:]]*=[[:space:]]*["'"'"']?prod|[sprk]k_live_'
|
|
182
|
+
guard_worktreeinclude() { # $1 proyecto · $2 = 1 si .worktreeinclude ya existia (es del usuario: se avisa, no se edita)
|
|
183
|
+
local wi="$1/.worktreeinclude" f tmp hit="" cr
|
|
184
|
+
[ -f "$wi" ] || return 0
|
|
185
|
+
cr="$(printf '\r')"; tmp="$(mktemp)"
|
|
186
|
+
while IFS= read -r f || [ -n "$f" ]; do
|
|
187
|
+
f="${f%"$cr"}"
|
|
188
|
+
case "$f" in
|
|
189
|
+
''|'#'*) printf '%s\n' "$f" ;;
|
|
190
|
+
*) if [ -f "$1/$f" ] && grep -Eiq "$PROD_MARK" "$1/$f" 2>/dev/null; then
|
|
191
|
+
hit="$hit $f"; printf '# %s <- desactivado: parece de produccion\n' "$f"
|
|
192
|
+
else printf '%s\n' "$f"; fi ;;
|
|
193
|
+
esac
|
|
194
|
+
done < "$wi" > "$tmp"
|
|
195
|
+
if [ -z "$hit" ]; then rm -f "$tmp"; return 0; fi
|
|
196
|
+
if [ "$2" -eq 1 ]; then
|
|
197
|
+
rm -f "$tmp"
|
|
198
|
+
item warn ".worktreeinclude copia ficheros que parecen de producción:$hit"
|
|
199
|
+
todo "$(basename "$1"): .worktreeinclude lista$hit, que parece(n) de producción. Quítalo(s) de la lista o usa un .env de desarrollo: cada worktree recibe una copia."
|
|
200
|
+
else
|
|
201
|
+
cat "$tmp" > "$wi"; rm -f "$tmp"
|
|
202
|
+
item warn ".worktreeinclude: desactivado$hit (parece de producción)"
|
|
203
|
+
todo "$(basename "$1"):$hit parece(n) de producción y no se copiará a los worktrees. Crea un .env de desarrollo (por ejemplo .env.development.local) o reactívalo en .worktreeinclude si de verdad es de desarrollo."
|
|
204
|
+
fi
|
|
205
|
+
}
|
|
137
206
|
write_file() { # $1 destino, stdin contenido
|
|
138
207
|
if [ "$DRY" -eq 1 ]; then cat >/dev/null; item dry "escribir $(short "$1")"; else mkdir -p "$(dirname "$1")"; cat > "$1"; fi
|
|
139
208
|
}
|
|
140
209
|
|
|
141
210
|
[ -f "$SRC/core/AGENTS.md" ] || { echo "No encuentro core/AGENTS.md en $SRC" >&2; exit 1; }
|
|
142
211
|
|
|
212
|
+
# ------------------------------------------------------------------ perfil de Claude de Orca
|
|
213
|
+
# Orca lanza Claude con CLAUDE_CONFIG_DIR apuntando a un perfil propio (orca/claude-profiles/<id>/home) que
|
|
214
|
+
# importa @~/.claude/CLAUDE.md y enlaza skills/, rules/... a ~/.claude. Ese perfil es de Orca: el kit instala en
|
|
215
|
+
# ~/.claude y el perfil lo hereda. Si el perfil no importa ~/.claude, no se toca Claude (escribir ahi no duraria).
|
|
216
|
+
ORCA_PROFILE=""; CLAUDE_SKIP=0
|
|
217
|
+
is_orca_profile() { # $1 ruta POSIX
|
|
218
|
+
case "$1" in */[Oo]rca/claude-profiles/*) return 0 ;; esac
|
|
219
|
+
[ -n "${ORCA_CLAUDE_INJECTED_CONFIG_DIR:-}" ] && [ "$(to_posix "$ORCA_CLAUDE_INJECTED_CONFIG_DIR")" = "$1" ]
|
|
220
|
+
}
|
|
221
|
+
if [ "$CLAUDE_DIR" != "$HOME/.claude" ] && is_orca_profile "$CLAUDE_DIR"; then
|
|
222
|
+
ORCA_PROFILE="$CLAUDE_DIR"
|
|
223
|
+
if grep -q '^@~/\.claude/CLAUDE\.md' "$ORCA_PROFILE/CLAUDE.md" 2>/dev/null; then
|
|
224
|
+
CLAUDE_DIR="$HOME/.claude"
|
|
225
|
+
else
|
|
226
|
+
CLAUDE_SKIP=1
|
|
227
|
+
todo "Claude Code: el perfil de Orca $(short "$ORCA_PROFILE") no importa @~/.claude/CLAUDE.md y no lo toco (es de Orca). Claude dentro de Orca no verá el kit hasta que ese perfil importe ~/.claude/CLAUDE.md."
|
|
228
|
+
fi
|
|
229
|
+
fi
|
|
230
|
+
|
|
143
231
|
# ------------------------------------------------------------------ restore
|
|
144
232
|
if [ -n "$RESTORE" ]; then
|
|
145
233
|
R="$AG/backups/$RESTORE"; [ -d "$R" ] || { echo "No existe la copia $R (consulta: omk backups)" >&2; exit 1; }
|
|
@@ -148,10 +236,14 @@ if [ -n "$RESTORE" ]; then
|
|
|
148
236
|
N=0
|
|
149
237
|
while IFS= read -r rel; do
|
|
150
238
|
[ -n "$rel" ] || continue
|
|
151
|
-
dest="$HOME/$rel"
|
|
152
|
-
# si algun directorio padre es ahora un enlace (p. ej. una skill enlazada),
|
|
239
|
+
case "$rel" in _abs/*) dest="/${rel#_abs/}" ;; *) dest="$HOME/$rel" ;; esac
|
|
240
|
+
# si algun directorio padre es ahora un enlace del kit (p. ej. una skill enlazada a ~/.agents), quitalo:
|
|
241
|
+
# no escribir a traves de el. Los enlaces ajenos (dotfiles, perfiles de Orca) se respetan.
|
|
153
242
|
p="$(dirname "$dest")"
|
|
154
|
-
while [ "$p" != "$HOME" ] && [ "$p" != "/" ]
|
|
243
|
+
while [ "$p" != "$HOME" ] && [ "$p" != "/" ] && [ "$p" != "." ]; do
|
|
244
|
+
if [ -L "$p" ]; then case "$(readlink "$p")" in "$AG"/*) run rm -f "$p" ;; esac; fi
|
|
245
|
+
p="$(dirname "$p")"
|
|
246
|
+
done
|
|
155
247
|
if [ -L "$dest" ] || [ -f "$dest" ]; then run rm -f "$dest"; fi
|
|
156
248
|
run mkdir -p "$(dirname "$dest")"; run cp -a "$R/$rel" "$dest"
|
|
157
249
|
N=$((N+1))
|
|
@@ -173,6 +265,11 @@ if [ -z "$AGENTS" ]; then
|
|
|
173
265
|
[ -d "$CURSOR_DIR" ] && AGENTS="$AGENTS,cursor"
|
|
174
266
|
AGENTS="${AGENTS#,}" # devin solo con --agents (opt-in)
|
|
175
267
|
fi
|
|
268
|
+
if [ "$CLAUDE_SKIP" -eq 1 ]; then
|
|
269
|
+
AGENTS="$(printf ',%s,' "$AGENTS" | sed 's/,claude,/,/; s/^,//; s/,$//')"
|
|
270
|
+
fi
|
|
271
|
+
[ -n "$ORCA_PROFILE" ] && [ "$CLAUDE_SKIP" -eq 0 ] && has_agent claude && \
|
|
272
|
+
info "Claude Code: perfil de Orca detectado ($(short "$ORCA_PROFILE")); se instala en ~/.claude, que el perfil importa. El perfil no se toca."
|
|
176
273
|
|
|
177
274
|
# ------------------------------------------------------------------ adopt
|
|
178
275
|
if [ -n "$ADOPT" ]; then
|
|
@@ -183,10 +280,11 @@ if [ -n "$ADOPT" ]; then
|
|
|
183
280
|
[ -e "$DEST" ] && { echo "Ya existe $DEST. Si es la misma skill, borra una de las dos copias antes." >&2; exit 1; }
|
|
184
281
|
title "Adoptar skill" "$NAME"
|
|
185
282
|
phase "Compartiendo $NAME con todos los agentes"
|
|
283
|
+
check_links
|
|
186
284
|
run mkdir -p "$BK" "$AG/skills"
|
|
187
285
|
run cp -a "$SKD" "$BK/$NAME.orig"
|
|
188
286
|
run mv "$SKD" "$DEST"
|
|
189
|
-
run ln -s "$DEST" "$SKD"
|
|
287
|
+
run ln -s "$DEST" "$SKD" || { echo "No se pudo crear el enlace $SKD -> $DEST. $LINK_HELP" >&2; exit 1; }
|
|
190
288
|
item add "copia única en $(short "$DEST")"
|
|
191
289
|
item add "en su sitio original queda un enlace"
|
|
192
290
|
case "$SKD" in "$CLAUDE_DIR"/skills/*) ;; *) has_agent claude && { link "$DEST" "$CLAUDE_DIR/skills/$NAME"; item add "enlazada en Claude Code"; } ;; esac
|
|
@@ -203,27 +301,41 @@ if [ "$VERIFY" -eq 1 ]; then
|
|
|
203
301
|
vok() { nok=$((nok+1)); if [ -n "$EV" ]; then ev "check::ok::$1"; else printf ' %s✓%s %s\n' "$C_L" "$C_0" "$1"; fi; }
|
|
204
302
|
vfail() { bad=$((bad+1)); if [ -n "$EV" ]; then ev "check::fail::$1"; else printf ' %s✗ %s%s\n' "$C_R" "$1" "$C_0"; fi; }
|
|
205
303
|
vinfo() { if [ -n "$EV" ]; then ev "check::info::$1"; else printf ' %s· %s%s\n' "$C_D" "$1" "$C_0"; fi; }
|
|
206
|
-
chk_link() {
|
|
304
|
+
chk_link() {
|
|
305
|
+
if [ -L "$3" ] && [ "$(readlink "$3")" = "$2" ]; then vok "$1"
|
|
306
|
+
elif [ -e "$3" ] && [ ! -L "$3" ]; then vfail "$1: $(short "$3") es una copia, no un enlace (acabará divergiendo; ejecuta omk install)"
|
|
307
|
+
else vfail "$1: $(short "$3") no enlaza a $(short "$2")"; fi; }
|
|
308
|
+
# Skills de un agente: separa las copias (divergen en silencio) de las que faltan o apuntan a otro sitio.
|
|
309
|
+
chk_skills() { # $1 agente · $2 carpeta de skills
|
|
310
|
+
local s ms="" cs=""
|
|
311
|
+
for s in $KIT_SKILLS; do
|
|
312
|
+
if [ -L "$2/$s" ] && [ "$(readlink "$2/$s")" = "$AG/skills/$s" ]; then continue; fi
|
|
313
|
+
if [ -e "$2/$s" ] && [ ! -L "$2/$s" ]; then cs="$cs $s"; else ms="$ms $s"; fi
|
|
314
|
+
done
|
|
315
|
+
[ -n "$cs" ] && vfail "$1: skills copiadas en vez de enlazadas (acabarán divergiendo; ejecuta omk install):$cs"
|
|
316
|
+
[ -n "$ms" ] && vfail "$1: skills sin enlazar:$ms"
|
|
317
|
+
[ -z "$cs$ms" ] && vok "$1: skills enlazadas"; return 0; }
|
|
207
318
|
title "Verificación" "$(agent_names)"
|
|
319
|
+
[ "$CLAUDE_SKIP" -eq 1 ] && vfail "Claude Code: el perfil de Orca $(short "$ORCA_PROFILE") no importa ~/.claude/CLAUDE.md, así que Claude en Orca no ve el kit"
|
|
208
320
|
[ -f "$AG/AGENTS.md" ] && vok "núcleo en ~/.agents/AGENTS.md (v$(cat "$AG/AGENT_KIT_VERSION" 2>/dev/null || echo '?'))" || vfail "falta ~/.agents/AGENTS.md: ejecuta omk install"
|
|
209
321
|
n=$(ls -1 "$AG/rules/lang"/*.md 2>/dev/null | wc -l | tr -d ' '); [ "$n" -ge 17 ] && vok "$n guías de lenguaje" || vfail "guías de lenguaje: $n de 17"
|
|
210
322
|
ms=""; for s in $KIT_SKILLS; do [ -f "$AG/skills/$s/SKILL.md" ] || ms="$ms $s"; done
|
|
211
323
|
[ -z "$ms" ] && vok "$NSK skills del kit" || vfail "faltan skills:$ms"
|
|
324
|
+
[ -f "$AG/skills/orca/references/olimpo.md" ] && vok "roles de Olimpo" || vfail "falta skills/orca/references/olimpo.md: ejecuta omk install"
|
|
325
|
+
[ -f "$AG/models.md" ] && vok "modelos por nivel en ~/.agents/models.md" || vfail "falta ~/.agents/models.md (qué modelo usa cada nivel): ejecuta omk install"
|
|
212
326
|
[ -f "$AG/speckit-ext/orca/extension.yml" ] && vok "extensión de spec-kit" || vfail "falta la extensión de spec-kit (~/.agents/speckit-ext/orca)"
|
|
213
327
|
for s in $OLD_SKILLS; do [ -e "$AG/skills/$s" ] && vfail "skill retirada sigue instalada: $s"; done
|
|
214
328
|
if has_agent claude; then
|
|
215
329
|
grep -q '@~/.agents/AGENTS.md' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null && vok "Claude Code: CLAUDE.md importa el núcleo" || vfail "Claude Code: CLAUDE.md no importa el núcleo"
|
|
216
330
|
grep -Eq '<!-- (CSR|MAW):BEGIN' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null && vfail "Claude Code: CLAUDE.md conserva bloques CSR/MAW antiguos" || true
|
|
217
331
|
for r in $OLD_RULES; do [ -e "$CLAUDE_DIR/rules/$r" ] && vfail "Claude Code: copia antigua $(short "$CLAUDE_DIR/rules/$r") (Claude la carga siempre)"; done
|
|
218
|
-
|
|
219
|
-
[ -z "$ms" ] && vok "Claude Code: skills enlazadas" || vfail "Claude Code: skills sin enlazar:$ms"
|
|
332
|
+
chk_skills "Claude Code" "$CLAUDE_DIR/skills"
|
|
220
333
|
fi
|
|
221
334
|
if has_agent antigravity; then
|
|
222
335
|
chk_link "Antigravity: GEMINI.md es el núcleo" "$AG/AGENTS.md" "$GEMINI_DIR/GEMINI.md"
|
|
223
336
|
for r in $OLD_RULES; do [ -e "$GEMINI_DIR/rules/$r" ] && vfail "Antigravity: copia antigua $(short "$GEMINI_DIR/rules/$r")"; done
|
|
224
337
|
[ -e "$GEMINI_DIR/config/plugins/claude-session-rules" ] && vfail "Antigravity: el plugin claude-session-rules sigue instalado (duplica csr-*)"
|
|
225
|
-
|
|
226
|
-
[ -z "$ms" ] && vok "Antigravity: skills enlazadas" || vfail "Antigravity: skills sin enlazar:$ms"
|
|
338
|
+
chk_skills "Antigravity" "$GEMINI_DIR/config/skills"
|
|
227
339
|
fi
|
|
228
340
|
has_agent codex && chk_link "Codex: AGENTS.md es el núcleo" "$AG/AGENTS.md" "$CODEX_DIR/AGENTS.md"
|
|
229
341
|
has_agent copilot && chk_link "Copilot CLI: copilot-instructions.md es el núcleo" "$AG/AGENTS.md" "$COPILOT_DIR/copilot-instructions.md"
|
|
@@ -241,6 +353,7 @@ if [ "$PROJECT_ONLY" -eq 0 ]; then
|
|
|
241
353
|
[ -n "$AGENTS" ] || { echo "No detecto ningún agente (Claude Code, Antigravity, Codex, Copilot o Cursor). Indica cuáles con --agents." >&2; exit 1; }
|
|
242
354
|
SUB="$(agent_names)"; [ "$DRY" -eq 1 ] && SUB="$SUB · simulación, no se escribe nada"
|
|
243
355
|
title "Orca Multiagent Kit v${VERSION}" "$SUB"
|
|
356
|
+
check_links
|
|
244
357
|
run mkdir -p "$BK"
|
|
245
358
|
|
|
246
359
|
# 1. Fuente canonica
|
|
@@ -262,6 +375,9 @@ if [ "$PROJECT_ONLY" -eq 0 ]; then
|
|
|
262
375
|
[ -e "$AG/speckit-ext/orca" ] && run rm -rf "$AG/speckit-ext/orca"
|
|
263
376
|
run cp -R "$SRC/speckit-extension/orca" "$AG/speckit-ext/orca"
|
|
264
377
|
NR=$(find "$SRC/rules" -name '*.md' | wc -l | tr -d ' '); NS=$NSK
|
|
378
|
+
# models.md es del usuario (que modelo usa cada nivel en cada proveedor): se crea una vez y no se pisa nunca.
|
|
379
|
+
if [ -e "$AG/models.md" ]; then item keep "models.md es tuyo: no se toca"
|
|
380
|
+
else run cp "$SRC/templates/models.md" "$AG/models.md"; item add "models.md creado (qué modelo usa cada nivel; edítalo cuando quieras)"; fi
|
|
265
381
|
if [ -z "$PREV" ]; then item add "instalada v${VERSION}"; elif [ "$PREV" = "$VERSION" ]; then item keep "v${VERSION} reinstalada"; else item add "actualizada de v${PREV} a v${VERSION}"; fi
|
|
266
382
|
done_phase "núcleo · $NR reglas · $NS skills · extensión de spec-kit"
|
|
267
383
|
|
|
@@ -369,9 +485,11 @@ if [ -n "$PROJECT" ]; then
|
|
|
369
485
|
item add "CLAUDE.md importa AGENTS.md"
|
|
370
486
|
grep -q '[^[:space:]]' "$REST" && todo "$PNAME: CLAUDE.md tiene reglas propias que solo ve Claude. Pide al agente «inicializa el proyecto» para pasarlas a AGENTS.md y que las vean todos."
|
|
371
487
|
rm -f "$TMP" "$REST"
|
|
488
|
+
[ -e "$PROJECT/.worktreeinclude" ] && HADWI=1 || HADWI=0
|
|
372
489
|
for f in STACK.md ORCHESTRATION.md orca.yaml .worktreeinclude; do
|
|
373
490
|
if [ -e "$PROJECT/$f" ]; then item keep "$f ya existía: no se toca"; else run cp "$SRC/templates/$f" "$PROJECT/$f"; item add "$f creado"; fi
|
|
374
491
|
done
|
|
492
|
+
guard_worktreeinclude "$PROJECT" "$HADWI"
|
|
375
493
|
if [ ! -e "$PROJECT/.claude/settings.json" ] && has_agent claude; then run mkdir -p "$PROJECT/.claude"; run cp "$SRC/templates/claude-settings.json" "$PROJECT/.claude/settings.json"; item add ".claude/settings.json creado"; fi
|
|
376
494
|
if [ -d "$PROJECT/.specify" ]; then
|
|
377
495
|
EXT="$PROJECT/.specify/extensions.yml"
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
* -text
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# Plugin de Orca — Orca Multiagent Kit
|
|
2
|
+
|
|
3
|
+
Integra el kit en la app [Orca](https://www.onorca.dev) (≥ 1.4.248). Qué hace, qué permisos pide y cómo instalarlo: [`docs/PLUGIN-ORCA.md`](../docs/PLUGIN-ORCA.md).
|
|
4
|
+
|
|
5
|
+
```sh
|
|
6
|
+
orca plugin validate . --json # manifiesto
|
|
7
|
+
orca plugin test . --json # src/*.test.ts con orca/testing
|
|
8
|
+
orca plugin inspect . --json # qué aporta y qué acceso pide
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
- `src/kit.ts`: lógica pura (detección de despachos, mensajes de "comando no encontrado", resumen de agentes).
|
|
12
|
+
- `src/worker.ts`: el worker que Orca carga; solo habla con Orca por su API.
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
{
|
|
2
|
+
"manifestVersion": 2,
|
|
3
|
+
"id": "multiagent-kit",
|
|
4
|
+
"name": "Orca Multiagent Kit",
|
|
5
|
+
"version": "0.1.0",
|
|
6
|
+
"description": "Comandos del kit en la paleta, el contrato del worker en cada despacho de orquestación del kit y los agentes activos en la barra de estado.",
|
|
7
|
+
"author": {
|
|
8
|
+
"name": "Fernando Baquero y Necro-Coder",
|
|
9
|
+
"url": "https://github.com/FernandoBaqueroo/orca-multiagent-kit"
|
|
10
|
+
},
|
|
11
|
+
"repository": "https://github.com/FernandoBaqueroo/orca-multiagent-kit",
|
|
12
|
+
"homepage": "https://github.com/FernandoBaqueroo/orca-multiagent-kit/blob/main/docs/PLUGIN-ORCA.md",
|
|
13
|
+
"license": "MIT",
|
|
14
|
+
"engines": {
|
|
15
|
+
"orca": ">=1.4.248"
|
|
16
|
+
},
|
|
17
|
+
"execution": "trusted-worker",
|
|
18
|
+
"pluginApi": 1,
|
|
19
|
+
"main": "src/worker.ts",
|
|
20
|
+
"capabilities": [
|
|
21
|
+
{ "kind": "workspace:read" },
|
|
22
|
+
{ "kind": "terminal:send" },
|
|
23
|
+
{ "kind": "terminal:read" },
|
|
24
|
+
{ "kind": "agent:launch" },
|
|
25
|
+
{ "kind": "agent:read" },
|
|
26
|
+
{ "kind": "notifications:show" },
|
|
27
|
+
{ "kind": "settings:own" }
|
|
28
|
+
],
|
|
29
|
+
"contributes": {
|
|
30
|
+
"commands": [
|
|
31
|
+
{ "id": "kit.verify", "title": "Orca Multiagent Kit: verificar instalación", "when": "workspace" },
|
|
32
|
+
{ "id": "kit.init", "title": "Orca Multiagent Kit: inicializar proyecto", "when": "workspace" },
|
|
33
|
+
{ "id": "kit.update", "title": "Orca Multiagent Kit: actualizar kit", "when": "workspace" },
|
|
34
|
+
{ "id": "agents.status", "title": "Orca Multiagent Kit: estado de los agentes" }
|
|
35
|
+
],
|
|
36
|
+
"hooks": [
|
|
37
|
+
{ "event": "agent.prompt.before", "onError": "pass" }
|
|
38
|
+
],
|
|
39
|
+
"events": [
|
|
40
|
+
{ "on": "agent.status.changed" },
|
|
41
|
+
{ "on": "workspace.removed" }
|
|
42
|
+
],
|
|
43
|
+
"statusBarItems": [
|
|
44
|
+
{
|
|
45
|
+
"id": "agents",
|
|
46
|
+
"text": "MAW",
|
|
47
|
+
"icon": "bot",
|
|
48
|
+
"tooltip": "Orca Multiagent Kit: agentes activos",
|
|
49
|
+
"command": "agents.status"
|
|
50
|
+
}
|
|
51
|
+
],
|
|
52
|
+
"settings": [
|
|
53
|
+
{
|
|
54
|
+
"key": "contractHint",
|
|
55
|
+
"title": "Contrato del worker en los despachos",
|
|
56
|
+
"description": "Añade a cada despacho de orquestación una línea que remite a ~/.agents/skills/orca/references/worker-contract.md. «Solo del kit» actúa en los despachos de la skill orca (cabecera UNIT/RUN).",
|
|
57
|
+
"type": "string",
|
|
58
|
+
"default": "kit",
|
|
59
|
+
"enum": ["kit", "all", "off"],
|
|
60
|
+
"enumLabels": ["Solo despachos del kit", "Todos los despachos", "Desactivado"]
|
|
61
|
+
},
|
|
62
|
+
{
|
|
63
|
+
"key": "statusBar",
|
|
64
|
+
"title": "Agentes en la barra de estado",
|
|
65
|
+
"description": "Muestra cuántos agentes trabajan, están bloqueados o esperan, en todos los workspaces.",
|
|
66
|
+
"type": "boolean",
|
|
67
|
+
"default": true
|
|
68
|
+
},
|
|
69
|
+
{
|
|
70
|
+
"key": "initAgent",
|
|
71
|
+
"title": "Agente para inicializar",
|
|
72
|
+
"description": "Id del agente que lanza «inicializar proyecto» con el prompt «inicializa el proyecto» (skill kit-init), por ejemplo claude o codex.",
|
|
73
|
+
"type": "string",
|
|
74
|
+
"default": "claude",
|
|
75
|
+
"maxLength": 40,
|
|
76
|
+
"placeholder": "claude"
|
|
77
|
+
}
|
|
78
|
+
]
|
|
79
|
+
}
|
|
80
|
+
}
|