orca-multiagent-kit 1.1.0 → 1.3.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 +3 -0
- package/CHANGELOG.md +51 -1
- package/README.md +10 -4
- package/VERSION +1 -1
- package/bin/omk.js +54 -20
- package/bin/ui.js +165 -0
- package/core/AGENTS.md +32 -29
- package/docs/CSR.md +95 -0
- package/docs/INSTALADOR-ORCA-WINDOWS.md +101 -0
- package/docs/MANUAL.md +3 -1
- package/docs/ORQUESTADOR.md +123 -0
- package/docs/PLUGIN-ORCA.md +102 -0
- package/install.sh +282 -92
- 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 +174 -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 +30 -9
- 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/orca/SKILL.md +17 -12
- 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 +2 -0
- package/skills/orca/references/engine-manual.md +5 -5
- package/skills/orca/references/engine-orca.md +64 -23
- package/skills/orca/references/engine-subagents.md +13 -4
- package/skills/orca/references/integrate.md +27 -15
- package/skills/orca/references/ledger.md +56 -0
- package/skills/orca/references/race.md +1 -0
- package/skills/orca/references/setup.md +3 -2
- package/skills/orca/references/units.md +7 -0
- package/skills/orca/references/worker-contract.md +24 -11
- package/skills/speckit-orca-implement/SKILL.md +2 -0
- package/speckit-extension/orca/commands/implement.md +2 -0
- package/templates/ORCHESTRATION.md +4 -0
- package/templates/STACK.md +2 -2
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"
|
|
@@ -29,50 +52,114 @@ OLD_SKILLS="maw-route maw-brief maw-plan maw-dispatch maw-worker maw-integrate m
|
|
|
29
52
|
OLD_RULES="00-router.md 10-communication.md 20-clean-code.md 30-security.md 31-security-audit.md 40-testing.md 50-done-gate.md 60-git-workflow.md 70-performance.md 75-reliability.md 80-supply-chain.md 90-docs-comments.md 95-multi-agent.md comunicacion-densa.md idioma-siempre.md"
|
|
30
53
|
OLD_LANGS="cpp csharp dart-flutter go infra java kotlin php python react ruby rust shell sql swift typescript web"
|
|
31
54
|
|
|
32
|
-
PROJECT=""; PROJECT_ONLY=0; VERIFY=0; DRY=0; AGENTS=""; RESTORE=""; ADOPT=""
|
|
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
|
|
45
68
|
done
|
|
46
69
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
70
|
+
# ------------------------------------------------------------------ salida
|
|
71
|
+
# Con OMK_EVENTS=1 (lo pone omk) se emiten eventos «::tipo::…» que omk dibuja con spinner y color.
|
|
72
|
+
# Sin él (./install.sh), el mismo contenido en texto, con color si es una terminal.
|
|
73
|
+
EV="${OMK_EVENTS:-}"
|
|
74
|
+
C_L=''; C_D=''; C_Y=''; C_R=''; C_B=''; C_0=''
|
|
75
|
+
if [ -z "$EV" ] && [ -t 1 ] && [ -z "${NO_COLOR:-}" ]; then
|
|
76
|
+
C_L=$'\033[38;5;154m'; C_D=$'\033[2m'; C_Y=$'\033[38;5;221m'; C_R=$'\033[38;5;203m'; C_B=$'\033[1m'; C_0=$'\033[0m'
|
|
77
|
+
fi
|
|
78
|
+
TODO=""; INFO=""; MOVED=0
|
|
79
|
+
ev() { printf '::%s\n' "$1"; }
|
|
80
|
+
title() { if [ -n "$EV" ]; then ev "title::$1::${2:-}"; else printf '\n%s%s%s %s%s%s\n%s%s%s\n\n' "$C_L$C_B" "■" "$C_0" "$C_B" "$1" "$C_0" "$C_D" "${2:-}" "$C_0"; fi; }
|
|
81
|
+
phase() { if [ -n "$EV" ]; then ev "begin::$1"; else printf ' %s›%s %s%s%s\n' "$C_L" "$C_0" "$C_B" "$1" "$C_0"; fi; }
|
|
82
|
+
done_phase() { if [ -n "$EV" ]; then ev "end::${1:-}"; elif [ -n "${1:-}" ]; then printf ' %s%s%s\n' "$C_D" "$1" "$C_0"; fi; return 0; }
|
|
83
|
+
item() { # $1 add|keep|dry|warn|fail · $2 texto
|
|
84
|
+
if [ -n "$EV" ]; then ev "item::$1::$2"; return 0; fi
|
|
85
|
+
case "$1" in add) m="$C_L+$C_0" ;; keep) m="$C_D=$C_0" ;; dry) m="$C_Y~$C_0" ;; fail) m="${C_R}✗${C_0}" ;; *) m="$C_Y!$C_0" ;; esac
|
|
86
|
+
printf ' %s %s\n' "$m" "$2"; }
|
|
87
|
+
todo() { TODO="${TODO}$1
|
|
88
|
+
"; if [ -n "$EV" ]; then ev "todo::$1"; fi; return 0; }
|
|
89
|
+
info() { INFO="${INFO}$1
|
|
90
|
+
"; if [ -n "$EV" ]; then ev "info::$1"; fi; return 0; }
|
|
91
|
+
short() { local x="$*"; x="${x//"$SRC"/<kit>}"; printf '%s' "${x//"$HOME"/~}"; }
|
|
92
|
+
run() { if [ "$DRY" -eq 1 ]; then item dry "$(short "$*")"; else "$@"; fi; }
|
|
93
|
+
# Resumen final: pendientes, información y siguientes pasos (solo texto; omk lo dibuja él)
|
|
94
|
+
footer() { # $1 global|project|both
|
|
95
|
+
local st=""; [ -d "$BK" ] && [ "$DRY" -eq 0 ] && st="$STAMP"
|
|
96
|
+
if [ -n "$EV" ]; then ev "footer::$1::$st::$DRY"; return 0; fi
|
|
97
|
+
if [ -n "$TODO" ]; then printf '\n%sPendiente%s\n' "$C_Y$C_B" "$C_0"; printf '%s' "$TODO" | while IFS= read -r l; do printf ' %s›%s %s\n' "$C_Y" "$C_0" "$l"; done; fi
|
|
98
|
+
if [ -n "$INFO" ]; then printf '\n%sPara tu información%s\n' "$C_D$C_B" "$C_0"; printf '%s' "$INFO" | while IFS= read -r l; do printf ' %s· %s%s\n' "$C_D" "$l" "$C_0"; done; fi
|
|
99
|
+
if [ "$DRY" -eq 1 ]; then printf '\n%sSimulación: no se ha escrito nada.%s\n\n' "$C_Y" "$C_0"; return 0; fi
|
|
100
|
+
printf '\n%s✓ Hecho%s\n' "$C_L$C_B" "$C_0"
|
|
101
|
+
case "$1" in
|
|
102
|
+
global) printf ' %scomprobar%s ./install.sh --verify\n %sproyecto%s ./install.sh --project-only <ruta>\n' "$C_D" "$C_0" "$C_D" "$C_0" ;;
|
|
103
|
+
*) printf ' %ssiguiente%s en el agente: «inicializa el proyecto»\n' "$C_D" "$C_0" ;;
|
|
104
|
+
esac
|
|
105
|
+
[ -n "$st" ] && printf ' %sdeshacer%s ./install.sh --restore %s\n' "$C_D" "$C_0" "$st"
|
|
106
|
+
printf '\n'; }
|
|
107
|
+
NSK=0; for _s in $KIT_SKILLS; do NSK=$((NSK+1)); done
|
|
108
|
+
# Cursor guarda las reglas de usuario en su base de datos de estado: basta con buscar la ruta del núcleo.
|
|
109
|
+
cursor_rule_set() {
|
|
110
|
+
local f
|
|
111
|
+
for f in "$HOME/Library/Application Support/Cursor/User/globalStorage/state.vscdb" "$HOME/.config/Cursor/User/globalStorage/state.vscdb"; do
|
|
112
|
+
[ -f "$f" ] && grep -aq '.agents/AGENTS.md' "$f" 2>/dev/null && return 0
|
|
113
|
+
done
|
|
114
|
+
return 1; }
|
|
115
|
+
agent_names() { local o="" a; for a in $(printf '%s' "$AGENTS" | tr ',' ' '); do
|
|
116
|
+
case "$a" in claude) a="Claude Code" ;; antigravity) a="Antigravity" ;; codex) a="Codex" ;; copilot) a="Copilot CLI" ;; cursor) a="Cursor" ;; devin) a="Devin" ;; esac
|
|
117
|
+
o="${o:+$o · }$a"; done; printf '%s' "$o"; }
|
|
51
118
|
has_agent() { case ",$AGENTS," in *",$1,"*) return 0 ;; *) return 1 ;; esac; }
|
|
52
119
|
|
|
53
|
-
#
|
|
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.
|
|
54
129
|
stash() {
|
|
55
130
|
local p="$1" rel
|
|
56
131
|
[ -e "$p" ] || [ -L "$p" ] || return 0
|
|
57
|
-
rel="$
|
|
132
|
+
rel="$(backup_rel "$p")"
|
|
58
133
|
run mkdir -p "$BK/$(dirname "$rel")"
|
|
59
134
|
run mv "$p" "$BK/$rel"
|
|
135
|
+
MOVED=$((MOVED+1))
|
|
60
136
|
}
|
|
61
137
|
# Copia (sin mover) una ruta al backup.
|
|
62
138
|
snapshot() {
|
|
63
139
|
local p="$1" rel
|
|
64
140
|
[ -e "$p" ] || return 0
|
|
65
|
-
rel="$
|
|
141
|
+
rel="$(backup_rel "$p")"
|
|
66
142
|
run mkdir -p "$BK/$(dirname "$rel")"
|
|
67
143
|
run cp -a "$p" "$BK/$rel"
|
|
68
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"
|
|
69
146
|
# Deja $2 como enlace simbolico a $1. Si habia otra cosa, va al backup.
|
|
70
147
|
link() {
|
|
71
148
|
local target="$1" l="$2"
|
|
72
149
|
if [ -L "$l" ] && [ "$(readlink "$l")" = "$target" ]; then return 0; fi
|
|
73
150
|
stash "$l"
|
|
74
151
|
run mkdir -p "$(dirname "$l")"
|
|
75
|
-
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
|
|
76
163
|
}
|
|
77
164
|
# Quita los bloques gestionados (CSR, MAW, AGENTS) de un fichero, conservando el resto.
|
|
78
165
|
strip_blocks() { # $1 fichero -> stdout
|
|
@@ -90,24 +177,55 @@ extract_overrides() { # $1 fichero -> stdout
|
|
|
90
177
|
inb && ov && !/^<!--/ && !/^-[[:space:]]*$/ && NF>0 {print}' "$1"
|
|
91
178
|
}
|
|
92
179
|
write_file() { # $1 destino, stdin contenido
|
|
93
|
-
if [ "$DRY" -eq 1 ]; then cat >/dev/null;
|
|
180
|
+
if [ "$DRY" -eq 1 ]; then cat >/dev/null; item dry "escribir $(short "$1")"; else mkdir -p "$(dirname "$1")"; cat > "$1"; fi
|
|
94
181
|
}
|
|
95
182
|
|
|
96
183
|
[ -f "$SRC/core/AGENTS.md" ] || { echo "No encuentro core/AGENTS.md en $SRC" >&2; exit 1; }
|
|
97
184
|
|
|
185
|
+
# ------------------------------------------------------------------ perfil de Claude de Orca
|
|
186
|
+
# Orca lanza Claude con CLAUDE_CONFIG_DIR apuntando a un perfil propio (orca/claude-profiles/<id>/home) que
|
|
187
|
+
# importa @~/.claude/CLAUDE.md y enlaza skills/, rules/... a ~/.claude. Ese perfil es de Orca: el kit instala en
|
|
188
|
+
# ~/.claude y el perfil lo hereda. Si el perfil no importa ~/.claude, no se toca Claude (escribir ahi no duraria).
|
|
189
|
+
ORCA_PROFILE=""; CLAUDE_SKIP=0
|
|
190
|
+
is_orca_profile() { # $1 ruta POSIX
|
|
191
|
+
case "$1" in */[Oo]rca/claude-profiles/*) return 0 ;; esac
|
|
192
|
+
[ -n "${ORCA_CLAUDE_INJECTED_CONFIG_DIR:-}" ] && [ "$(to_posix "$ORCA_CLAUDE_INJECTED_CONFIG_DIR")" = "$1" ]
|
|
193
|
+
}
|
|
194
|
+
if [ "$CLAUDE_DIR" != "$HOME/.claude" ] && is_orca_profile "$CLAUDE_DIR"; then
|
|
195
|
+
ORCA_PROFILE="$CLAUDE_DIR"
|
|
196
|
+
if grep -q '^@~/\.claude/CLAUDE\.md' "$ORCA_PROFILE/CLAUDE.md" 2>/dev/null; then
|
|
197
|
+
CLAUDE_DIR="$HOME/.claude"
|
|
198
|
+
else
|
|
199
|
+
CLAUDE_SKIP=1
|
|
200
|
+
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."
|
|
201
|
+
fi
|
|
202
|
+
fi
|
|
203
|
+
|
|
98
204
|
# ------------------------------------------------------------------ restore
|
|
99
205
|
if [ -n "$RESTORE" ]; then
|
|
100
|
-
R="$AG/backups/$RESTORE"; [ -d "$R" ] || { echo "No existe $R" >&2; exit 1; }
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
206
|
+
R="$AG/backups/$RESTORE"; [ -d "$R" ] || { echo "No existe la copia $R (consulta: omk backups)" >&2; exit 1; }
|
|
207
|
+
title "Restaurar" "copia $RESTORE"
|
|
208
|
+
phase "Devolviendo ficheros a su sitio"
|
|
209
|
+
N=0
|
|
210
|
+
while IFS= read -r rel; do
|
|
211
|
+
[ -n "$rel" ] || continue
|
|
212
|
+
case "$rel" in _abs/*) dest="/${rel#_abs/}" ;; *) dest="$HOME/$rel" ;; esac
|
|
213
|
+
# si algun directorio padre es ahora un enlace del kit (p. ej. una skill enlazada a ~/.agents), quitalo:
|
|
214
|
+
# no escribir a traves de el. Los enlaces ajenos (dotfiles, perfiles de Orca) se respetan.
|
|
105
215
|
p="$(dirname "$dest")"
|
|
106
|
-
while [ "$p" != "$HOME" ] && [ "$p" != "/" ]
|
|
216
|
+
while [ "$p" != "$HOME" ] && [ "$p" != "/" ] && [ "$p" != "." ]; do
|
|
217
|
+
if [ -L "$p" ]; then case "$(readlink "$p")" in "$AG"/*) run rm -f "$p" ;; esac; fi
|
|
218
|
+
p="$(dirname "$p")"
|
|
219
|
+
done
|
|
107
220
|
if [ -L "$dest" ] || [ -f "$dest" ]; then run rm -f "$dest"; fi
|
|
108
221
|
run mkdir -p "$(dirname "$dest")"; run cp -a "$R/$rel" "$dest"
|
|
109
|
-
|
|
110
|
-
|
|
222
|
+
N=$((N+1))
|
|
223
|
+
done <<EOF
|
|
224
|
+
$(cd "$R" && find . \( -type f -o -type l \) | sed 's#^\./##')
|
|
225
|
+
EOF
|
|
226
|
+
done_phase "$N ficheros restaurados"
|
|
227
|
+
info "Los enlaces que el kit creó donde antes no había nada siguen ahí; bórralos a mano si quieres."
|
|
228
|
+
if [ -n "$EV" ]; then ev "footer::restore::$RESTORE::$DRY"; else printf '\n%s✓ Restaurado%s\n\n' "$C_L$C_B" "$C_0"; fi
|
|
111
229
|
exit 0
|
|
112
230
|
fi
|
|
113
231
|
|
|
@@ -120,6 +238,11 @@ if [ -z "$AGENTS" ]; then
|
|
|
120
238
|
[ -d "$CURSOR_DIR" ] && AGENTS="$AGENTS,cursor"
|
|
121
239
|
AGENTS="${AGENTS#,}" # devin solo con --agents (opt-in)
|
|
122
240
|
fi
|
|
241
|
+
if [ "$CLAUDE_SKIP" -eq 1 ]; then
|
|
242
|
+
AGENTS="$(printf ',%s,' "$AGENTS" | sed 's/,claude,/,/; s/^,//; s/,$//')"
|
|
243
|
+
fi
|
|
244
|
+
[ -n "$ORCA_PROFILE" ] && [ "$CLAUDE_SKIP" -eq 0 ] && has_agent claude && \
|
|
245
|
+
info "Claude Code: perfil de Orca detectado ($(short "$ORCA_PROFILE")); se instala en ~/.claude, que el perfil importa. El perfil no se toca."
|
|
123
246
|
|
|
124
247
|
# ------------------------------------------------------------------ adopt
|
|
125
248
|
if [ -n "$ADOPT" ]; then
|
|
@@ -128,56 +251,85 @@ if [ -n "$ADOPT" ]; then
|
|
|
128
251
|
[ -L "$SKD" ] && { echo "Ya es un enlace: $SKD -> $(readlink "$SKD")" >&2; exit 1; }
|
|
129
252
|
NAME="$(basename "$SKD")"; DEST="$AG/skills/$NAME"
|
|
130
253
|
[ -e "$DEST" ] && { echo "Ya existe $DEST. Si es la misma skill, borra una de las dos copias antes." >&2; exit 1; }
|
|
131
|
-
|
|
254
|
+
title "Adoptar skill" "$NAME"
|
|
255
|
+
phase "Compartiendo $NAME con todos los agentes"
|
|
256
|
+
check_links
|
|
132
257
|
run mkdir -p "$BK" "$AG/skills"
|
|
133
258
|
run cp -a "$SKD" "$BK/$NAME.orig"
|
|
134
259
|
run mv "$SKD" "$DEST"
|
|
135
|
-
run ln -s "$DEST" "$SKD"
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
260
|
+
run ln -s "$DEST" "$SKD" || { echo "No se pudo crear el enlace $SKD -> $DEST. $LINK_HELP" >&2; exit 1; }
|
|
261
|
+
item add "copia única en $(short "$DEST")"
|
|
262
|
+
item add "en su sitio original queda un enlace"
|
|
263
|
+
case "$SKD" in "$CLAUDE_DIR"/skills/*) ;; *) has_agent claude && { link "$DEST" "$CLAUDE_DIR/skills/$NAME"; item add "enlazada en Claude Code"; } ;; esac
|
|
264
|
+
case "$SKD" in "$GEMINI_DIR"/*) ;; *) has_agent antigravity && { link "$DEST" "$GEMINI_DIR/config/skills/$NAME"; item add "enlazada en Antigravity"; } ;; esac
|
|
265
|
+
done_phase "Codex, Copilot y Cursor la leen desde ~/.agents/skills"
|
|
266
|
+
info "Si la skill se actualiza con su propio instalador, vuelve a adoptarla."
|
|
267
|
+
footer global
|
|
139
268
|
exit 0
|
|
140
269
|
fi
|
|
141
270
|
|
|
142
271
|
# ------------------------------------------------------------------ verify
|
|
143
272
|
if [ "$VERIFY" -eq 1 ]; then
|
|
144
|
-
bad=0
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
273
|
+
bad=0; nok=0
|
|
274
|
+
vok() { nok=$((nok+1)); if [ -n "$EV" ]; then ev "check::ok::$1"; else printf ' %s✓%s %s\n' "$C_L" "$C_0" "$1"; fi; }
|
|
275
|
+
vfail() { bad=$((bad+1)); if [ -n "$EV" ]; then ev "check::fail::$1"; else printf ' %s✗ %s%s\n' "$C_R" "$1" "$C_0"; fi; }
|
|
276
|
+
vinfo() { if [ -n "$EV" ]; then ev "check::info::$1"; else printf ' %s· %s%s\n' "$C_D" "$1" "$C_0"; fi; }
|
|
277
|
+
chk_link() {
|
|
278
|
+
if [ -L "$3" ] && [ "$(readlink "$3")" = "$2" ]; then vok "$1"
|
|
279
|
+
elif [ -e "$3" ] && [ ! -L "$3" ]; then vfail "$1: $(short "$3") es una copia, no un enlace (acabará divergiendo; ejecuta omk install)"
|
|
280
|
+
else vfail "$1: $(short "$3") no enlaza a $(short "$2")"; fi; }
|
|
281
|
+
# Skills de un agente: separa las copias (divergen en silencio) de las que faltan o apuntan a otro sitio.
|
|
282
|
+
chk_skills() { # $1 agente · $2 carpeta de skills
|
|
283
|
+
local s ms="" cs=""
|
|
284
|
+
for s in $KIT_SKILLS; do
|
|
285
|
+
if [ -L "$2/$s" ] && [ "$(readlink "$2/$s")" = "$AG/skills/$s" ]; then continue; fi
|
|
286
|
+
if [ -e "$2/$s" ] && [ ! -L "$2/$s" ]; then cs="$cs $s"; else ms="$ms $s"; fi
|
|
287
|
+
done
|
|
288
|
+
[ -n "$cs" ] && vfail "$1: skills copiadas en vez de enlazadas (acabarán divergiendo; ejecuta omk install):$cs"
|
|
289
|
+
[ -n "$ms" ] && vfail "$1: skills sin enlazar:$ms"
|
|
290
|
+
[ -z "$cs$ms" ] && vok "$1: skills enlazadas"; return 0; }
|
|
291
|
+
title "Verificación" "$(agent_names)"
|
|
292
|
+
[ "$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"
|
|
293
|
+
[ -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"
|
|
294
|
+
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"
|
|
295
|
+
ms=""; for s in $KIT_SKILLS; do [ -f "$AG/skills/$s/SKILL.md" ] || ms="$ms $s"; done
|
|
296
|
+
[ -z "$ms" ] && vok "$NSK skills del kit" || vfail "faltan skills:$ms"
|
|
297
|
+
[ -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)"
|
|
298
|
+
for s in $OLD_SKILLS; do [ -e "$AG/skills/$s" ] && vfail "skill retirada sigue instalada: $s"; done
|
|
153
299
|
if has_agent claude; then
|
|
154
|
-
grep -q '@~/.agents/AGENTS.md' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null &&
|
|
155
|
-
grep -Eq '<!-- (CSR|MAW):BEGIN' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null &&
|
|
156
|
-
for r in $OLD_RULES; do [ -e "$CLAUDE_DIR/rules/$r" ] &&
|
|
157
|
-
|
|
300
|
+
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"
|
|
301
|
+
grep -Eq '<!-- (CSR|MAW):BEGIN' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null && vfail "Claude Code: CLAUDE.md conserva bloques CSR/MAW antiguos" || true
|
|
302
|
+
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
|
|
303
|
+
chk_skills "Claude Code" "$CLAUDE_DIR/skills"
|
|
158
304
|
fi
|
|
159
305
|
if has_agent antigravity; then
|
|
160
|
-
chk_link "$AG/AGENTS.md" "$GEMINI_DIR/GEMINI.md"
|
|
161
|
-
for r in $OLD_RULES; do [ -e "$GEMINI_DIR/rules/$r" ] &&
|
|
162
|
-
[ -e "$GEMINI_DIR/config/plugins/claude-session-rules" ] &&
|
|
163
|
-
|
|
306
|
+
chk_link "Antigravity: GEMINI.md es el núcleo" "$AG/AGENTS.md" "$GEMINI_DIR/GEMINI.md"
|
|
307
|
+
for r in $OLD_RULES; do [ -e "$GEMINI_DIR/rules/$r" ] && vfail "Antigravity: copia antigua $(short "$GEMINI_DIR/rules/$r")"; done
|
|
308
|
+
[ -e "$GEMINI_DIR/config/plugins/claude-session-rules" ] && vfail "Antigravity: el plugin claude-session-rules sigue instalado (duplica csr-*)"
|
|
309
|
+
chk_skills "Antigravity" "$GEMINI_DIR/config/skills"
|
|
164
310
|
fi
|
|
165
|
-
has_agent codex && chk_link "$AG/AGENTS.md" "$CODEX_DIR/AGENTS.md"
|
|
166
|
-
has_agent copilot && chk_link "$AG/AGENTS.md" "$COPILOT_DIR/copilot-instructions.md"
|
|
167
|
-
has_agent devin && chk_link "$AG/AGENTS.md" "$DEVIN_DIR/AGENTS.md"
|
|
168
|
-
has_agent cursor
|
|
169
|
-
|
|
170
|
-
|
|
311
|
+
has_agent codex && chk_link "Codex: AGENTS.md es el núcleo" "$AG/AGENTS.md" "$CODEX_DIR/AGENTS.md"
|
|
312
|
+
has_agent copilot && chk_link "Copilot CLI: copilot-instructions.md es el núcleo" "$AG/AGENTS.md" "$COPILOT_DIR/copilot-instructions.md"
|
|
313
|
+
has_agent devin && chk_link "Devin: AGENTS.md es el núcleo" "$AG/AGENTS.md" "$DEVIN_DIR/AGENTS.md"
|
|
314
|
+
if has_agent cursor; then
|
|
315
|
+
if cursor_rule_set; then vok "Cursor: regla de usuario configurada"; else vinfo "Cursor: no veo la regla de usuario que apunta a ~/.agents/AGENTS.md (Settings → Rules)"; fi
|
|
316
|
+
fi
|
|
317
|
+
if [ -n "$EV" ]; then ev "result::$bad::$nok"; exit $((bad > 0)); fi
|
|
318
|
+
if [ "$bad" -eq 0 ]; then printf '\n%s✓ Todo correcto%s %s%s comprobaciones%s\n\n' "$C_L$C_B" "$C_0" "$C_D" "$nok" "$C_0"; exit 0; fi
|
|
319
|
+
printf '\n%s✗ %s fallos%s %sejecuta «omk install» para repararlos%s\n\n' "$C_R$C_B" "$bad" "$C_0" "$C_D" "$C_0"; exit 1
|
|
171
320
|
fi
|
|
172
321
|
|
|
173
322
|
# ------------------------------------------------------------------ global
|
|
174
323
|
if [ "$PROJECT_ONLY" -eq 0 ]; then
|
|
175
|
-
[ -n "$AGENTS" ] || { echo "No detecto
|
|
176
|
-
|
|
177
|
-
|
|
324
|
+
[ -n "$AGENTS" ] || { echo "No detecto ningún agente (Claude Code, Antigravity, Codex, Copilot o Cursor). Indica cuáles con --agents." >&2; exit 1; }
|
|
325
|
+
SUB="$(agent_names)"; [ "$DRY" -eq 1 ] && SUB="$SUB · simulación, no se escribe nada"
|
|
326
|
+
title "Orca Multiagent Kit v${VERSION}" "$SUB"
|
|
327
|
+
check_links
|
|
178
328
|
run mkdir -p "$BK"
|
|
179
329
|
|
|
180
330
|
# 1. Fuente canonica
|
|
331
|
+
phase "Fuente única en ~/.agents"
|
|
332
|
+
PREV="$(cat "$AG/AGENT_KIT_VERSION" 2>/dev/null || true)"
|
|
181
333
|
[ -f "$AG/AGENTS.md" ] && snapshot "$AG/AGENTS.md"
|
|
182
334
|
run mkdir -p "$AG/rules" "$AG/skills" "$AG/templates" "$AG/output-styles"
|
|
183
335
|
run cp "$SRC/core/AGENTS.md" "$AG/AGENTS.md"
|
|
@@ -190,21 +342,31 @@ if [ "$PROJECT_ONLY" -eq 0 ]; then
|
|
|
190
342
|
run cp -R "$SRC/templates/." "$AG/templates/"
|
|
191
343
|
run cp -R "$SRC/output-styles/." "$AG/output-styles/"
|
|
192
344
|
run cp "$SRC/VERSION" "$AG/AGENT_KIT_VERSION"
|
|
345
|
+
run mkdir -p "$AG/speckit-ext"
|
|
346
|
+
[ -e "$AG/speckit-ext/orca" ] && run rm -rf "$AG/speckit-ext/orca"
|
|
347
|
+
run cp -R "$SRC/speckit-extension/orca" "$AG/speckit-ext/orca"
|
|
348
|
+
NR=$(find "$SRC/rules" -name '*.md' | wc -l | tr -d ' '); NS=$NSK
|
|
349
|
+
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
|
|
350
|
+
done_phase "núcleo · $NR reglas · $NS skills · extensión de spec-kit"
|
|
351
|
+
|
|
352
|
+
# 2. Restos de versiones anteriores
|
|
353
|
+
phase "Versiones anteriores"
|
|
354
|
+
M0=$MOVED
|
|
193
355
|
[ -d "$AG/maw" ] && stash "$AG/maw" # restos de MAW v1
|
|
194
356
|
for s in $OLD_SKILLS; do
|
|
195
357
|
stash "$AG/skills/$s"; stash "$CLAUDE_DIR/skills/$s"; stash "$GEMINI_DIR/config/skills/$s"
|
|
196
358
|
done
|
|
197
|
-
|
|
198
|
-
[ -e "$AG/speckit-ext/orca" ] && run rm -rf "$AG/speckit-ext/orca"
|
|
199
|
-
run cp -R "$SRC/speckit-extension/orca" "$AG/speckit-ext/orca"
|
|
359
|
+
if [ $((MOVED-M0)) -gt 0 ]; then done_phase "$((MOVED-M0)) elementos retirados a la copia de seguridad"; else done_phase "nada que retirar"; fi
|
|
200
360
|
|
|
201
|
-
#
|
|
361
|
+
# 3. Claude Code: import en CLAUDE.md; reglas fuera de ~/.claude/rules (Claude carga TODO lo que hay ahi)
|
|
202
362
|
if has_agent claude; then
|
|
203
|
-
|
|
363
|
+
phase "Claude Code"
|
|
364
|
+
M0=$MOVED
|
|
204
365
|
if [ -L "$CLAUDE_DIR/CLAUDE.md" ]; then stash "$CLAUDE_DIR/CLAUDE.md"; fi
|
|
205
366
|
[ -f "$CLAUDE_DIR/CLAUDE.md" ] && snapshot "$CLAUDE_DIR/CLAUDE.md"
|
|
206
367
|
TMP="$(mktemp)"; [ -f "$CLAUDE_DIR/CLAUDE.md" ] && strip_blocks "$CLAUDE_DIR/CLAUDE.md" > "$TMP"
|
|
207
368
|
{ printf '<!-- AGENTS:BEGIN v%s Orca Multiagent Kit -- reglas globales: edita ~/.agents/AGENTS.md, no este bloque -->\n@~/.agents/AGENTS.md\n<!-- AGENTS:END -->\n' "$VERSION"; [ -s "$TMP" ] && { printf '\n'; cat "$TMP"; }; true; } | write_file "$CLAUDE_DIR/CLAUDE.md"
|
|
369
|
+
[ -s "$TMP" ] && KEPT=1 || KEPT=0
|
|
208
370
|
rm -f "$TMP"
|
|
209
371
|
for r in $OLD_RULES; do stash "$CLAUDE_DIR/rules/$r"; done
|
|
210
372
|
for l in $OLD_LANGS; do stash "$CLAUDE_DIR/rules/lang/$l.md"; done
|
|
@@ -212,17 +374,21 @@ if [ "$PROJECT_ONLY" -eq 0 ]; then
|
|
|
212
374
|
for s in $KIT_SKILLS; do link "$AG/skills/$s" "$CLAUDE_DIR/skills/$s"; done
|
|
213
375
|
link "$AG/output-styles/csr-minimal.md" "$CLAUDE_DIR/output-styles/csr-minimal.md"
|
|
214
376
|
stash "$CLAUDE_DIR/templates/STACK.md"; stash "$CLAUDE_DIR/templates/project-CLAUDE.md"
|
|
215
|
-
|
|
377
|
+
item add "CLAUDE.md importa el núcleo"
|
|
378
|
+
[ "$KEPT" -eq 1 ] && item keep "tu contenido propio de CLAUDE.md se conserva debajo"
|
|
379
|
+
item add "$NS skills enlazadas · estilo csr-minimal"
|
|
380
|
+
[ $((MOVED-M0)) -gt 0 ] && item add "$((MOVED-M0)) copias antiguas de reglas retiradas"
|
|
381
|
+
done_phase
|
|
382
|
+
info "Claude Code: en la app de escritorio (Cowork) no se cargan imports de fuera de la carpeta de trabajo; en la terminal y el IDE sí."
|
|
216
383
|
fi
|
|
217
384
|
|
|
218
|
-
#
|
|
385
|
+
# 4. Antigravity: GEMINI.md pasa a ser un enlace a la fuente unica
|
|
219
386
|
if has_agent antigravity; then
|
|
220
|
-
|
|
387
|
+
phase "Antigravity"
|
|
388
|
+
M0=$MOVED
|
|
221
389
|
if [ -f "$GEMINI_DIR/GEMINI.md" ] && [ ! -L "$GEMINI_DIR/GEMINI.md" ]; then
|
|
222
390
|
EXTRA="$(strip_blocks "$GEMINI_DIR/GEMINI.md" | grep -v '^[[:space:]]*$' || true)"
|
|
223
|
-
|
|
224
|
-
warn "Antigravity: GEMINI.md tenia contenido fuera de los bloques (va al backup). Idioma y comunicacion ya estan en AGENTS.md; si habia algo mas tuyo, pasalo a ~/.agents/rules/personal.md"
|
|
225
|
-
fi
|
|
391
|
+
[ -n "$EXTRA" ] && info "Antigravity: lo que tenías en GEMINI.md fuera de los bloques está en la copia de seguridad. Si era tuyo, pásalo a ~/.agents/rules/personal.md."
|
|
226
392
|
fi
|
|
227
393
|
link "$AG/AGENTS.md" "$GEMINI_DIR/GEMINI.md"
|
|
228
394
|
for r in $OLD_RULES; do stash "$GEMINI_DIR/rules/$r"; done
|
|
@@ -232,66 +398,90 @@ if [ "$PROJECT_ONLY" -eq 0 ]; then
|
|
|
232
398
|
stash "$GEMINI_DIR/output-styles/csr-minimal.md"
|
|
233
399
|
if [ -e "$GEMINI_DIR/config/plugins/claude-session-rules" ]; then
|
|
234
400
|
stash "$GEMINI_DIR/config/plugins/claude-session-rules"
|
|
235
|
-
|
|
401
|
+
item add "plugin claude-session-rules retirado (ya está en la fuente única)"
|
|
402
|
+
info "Antigravity: si se queja de un plugin ausente (claude-session-rules), desactívalo en su configuración."
|
|
236
403
|
fi
|
|
237
404
|
for s in $KIT_SKILLS; do link "$AG/skills/$s" "$GEMINI_DIR/config/skills/$s"; done
|
|
238
|
-
|
|
405
|
+
item add "GEMINI.md es un enlace al núcleo"
|
|
406
|
+
item add "$NS skills enlazadas"
|
|
407
|
+
[ $((MOVED-M0)) -gt 0 ] && item add "$((MOVED-M0)) copias antiguas retiradas"
|
|
408
|
+
done_phase
|
|
409
|
+
[ -d "$GEMINI_DIR/config/plugins/user-workflows/skills/planificar" ] && todo "Antigravity: desactiva la skill «planificar» cuando hayas probado «orca», que la sustituye."
|
|
239
410
|
fi
|
|
240
411
|
|
|
241
|
-
#
|
|
242
|
-
if has_agent codex; then
|
|
243
|
-
if has_agent copilot; then
|
|
244
|
-
if has_agent devin; then
|
|
245
|
-
|
|
246
|
-
if has_agent cursor; then
|
|
247
|
-
|
|
248
|
-
|
|
412
|
+
# 5. Agentes que leen ~/.agents/skills de forma nativa: solo hay que enlazar las reglas globales
|
|
413
|
+
if has_agent codex; then phase "Codex"; link "$AG/AGENTS.md" "$CODEX_DIR/AGENTS.md"; item add "AGENTS.md es un enlace al núcleo"; item add "skills: las lee de ~/.agents/skills"; done_phase; fi
|
|
414
|
+
if has_agent copilot; then phase "Copilot CLI"; link "$AG/AGENTS.md" "$COPILOT_DIR/copilot-instructions.md"; item add "copilot-instructions.md es un enlace al núcleo"; item add "skills: las lee de ~/.agents/skills"; done_phase; fi
|
|
415
|
+
if has_agent devin; then phase "Devin"; link "$AG/AGENTS.md" "$DEVIN_DIR/AGENTS.md"; item add "AGENTS.md es un enlace al núcleo"; done_phase
|
|
416
|
+
info "Devin: también lee ~/.claude/CLAUDE.md; si ves reglas duplicadas, quita uno de los dos."; fi
|
|
417
|
+
if has_agent cursor; then phase "Cursor"
|
|
418
|
+
item add "skills: las lee de ~/.agents/skills"
|
|
419
|
+
if cursor_rule_set; then item keep "regla de usuario ya configurada"; else
|
|
420
|
+
item warn "falta la regla de usuario (Cursor no la guarda en un fichero)"
|
|
421
|
+
todo "Cursor: añade en Settings → Rules → User Rules una regla con este texto: «Al empezar, lee y aplica ~/.agents/AGENTS.md y, bajo demanda, ~/.agents/rules/»"
|
|
422
|
+
fi
|
|
423
|
+
done_phase
|
|
424
|
+
has_agent claude && info "Cursor: también lee ~/.claude/skills, así que puede listar las skills dos veces (con el mismo contenido)."
|
|
425
|
+
fi
|
|
249
426
|
fi
|
|
250
427
|
|
|
251
428
|
# ------------------------------------------------------------------ proyecto
|
|
252
429
|
if [ -n "$PROJECT" ]; then
|
|
253
430
|
[ -d "$PROJECT" ] || { echo "No existe la ruta de proyecto: $PROJECT" >&2; exit 1; }
|
|
254
|
-
|
|
431
|
+
PNAME="$(basename "$PROJECT")"
|
|
432
|
+
[ "$PROJECT_ONLY" -eq 1 ] && title "Orca Multiagent Kit v${VERSION}" "proyecto $(short "$PROJECT")$([ "$DRY" -eq 1 ] && echo ' · simulación')"
|
|
433
|
+
phase "Proyecto $PNAME"
|
|
434
|
+
INSTALLED="$(cat "$AG/AGENT_KIT_VERSION" 2>/dev/null || true)"
|
|
435
|
+
if [ "$PROJECT_ONLY" -eq 1 ] && [ "$INSTALLED" != "$VERSION" ]; then
|
|
436
|
+
if [ -n "${OMK_CLI:-}" ]; then FIX="omk install"; else FIX="./install.sh"; fi
|
|
437
|
+
todo "Instalación global: en ~/.agents hay ${INSTALLED:-una versión sin instalar} y este kit es v${VERSION}. Ejecuta «${FIX}» para tener las skills orca y kit-init."
|
|
438
|
+
fi
|
|
255
439
|
OV=""
|
|
256
440
|
for f in "$PROJECT/CLAUDE.md" "$PROJECT/AGENTS.md"; do [ -f "$f" ] && OV="$OV$(extract_overrides "$f")
|
|
257
441
|
"; done
|
|
258
442
|
OV="$(printf '%s' "$OV" | awk 'NF && !seen[$0]++')"
|
|
259
443
|
for f in AGENTS.md CLAUDE.md; do [ -f "$PROJECT/$f" ] && snapshot "$PROJECT/$f"; done
|
|
444
|
+
[ -f "$PROJECT/AGENTS.md" ] && HADAG=1 || HADAG=0
|
|
260
445
|
|
|
261
446
|
TMP="$(mktemp)"; [ -f "$PROJECT/AGENTS.md" ] && strip_blocks "$PROJECT/AGENTS.md" > "$TMP"
|
|
262
447
|
{ if [ -n "$OV" ]; then OV="$OV" awk '/^-$/ && !d {print ENVIRON["OV"]; d=1; next} {print}' "$SRC/templates/AGENTS.md"; else cat "$SRC/templates/AGENTS.md"; fi
|
|
263
448
|
[ -s "$TMP" ] && { printf '\n'; cat "$TMP"; }; true; } | write_file "$PROJECT/AGENTS.md"
|
|
264
449
|
REST="$(mktemp)"; [ -f "$PROJECT/CLAUDE.md" ] && strip_blocks "$PROJECT/CLAUDE.md" > "$REST"
|
|
265
450
|
{ cat "$SRC/templates/CLAUDE.md"; [ -s "$REST" ] && { printf '\n'; cat "$REST"; }; true; } | write_file "$PROJECT/CLAUDE.md"
|
|
266
|
-
|
|
451
|
+
if [ "$HADAG" -eq 1 ]; then item add "AGENTS.md actualizado (tu contenido se conserva)"; else item add "AGENTS.md creado"; fi
|
|
452
|
+
[ -n "$OV" ] && item add "overrides del proyecto movidos a AGENTS.md"
|
|
453
|
+
item add "CLAUDE.md importa AGENTS.md"
|
|
454
|
+
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."
|
|
267
455
|
rm -f "$TMP" "$REST"
|
|
268
|
-
[ -n "$OV" ] && step " overrides migrados a AGENTS.md"
|
|
269
456
|
for f in STACK.md ORCHESTRATION.md orca.yaml .worktreeinclude; do
|
|
270
|
-
if [ -e "$PROJECT/$f" ]; then
|
|
457
|
+
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
|
|
271
458
|
done
|
|
272
|
-
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";
|
|
459
|
+
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
|
|
273
460
|
if [ -d "$PROJECT/.specify" ]; then
|
|
274
461
|
EXT="$PROJECT/.specify/extensions.yml"
|
|
275
|
-
if grep -q 'speckit.orca.implement' "$EXT" 2>/dev/null; then
|
|
462
|
+
if grep -q 'speckit.orca.implement' "$EXT" 2>/dev/null; then item keep "spec-kit: el hook de orquestación ya estaba activo"
|
|
276
463
|
elif command -v specify >/dev/null 2>&1; then
|
|
277
|
-
|
|
278
|
-
|
|
464
|
+
SKX="$AG/speckit-ext/orca"; [ -f "$SKX/extension.yml" ] || SKX="$SRC/speckit-extension/orca"
|
|
465
|
+
if (cd "$PROJECT" && run specify extension add --dev "$SKX") >/dev/null 2>&1; then item add "spec-kit: extensión orca instalada (hook before_implement)"
|
|
466
|
+
else item warn "spec-kit: «specify extension add» ha fallado"; todo "$PNAME: no se pudo activar el hook de spec-kit. Pide al agente «inicializa el proyecto» y lo añadirá."; fi
|
|
279
467
|
elif [ ! -e "$EXT" ]; then
|
|
280
468
|
# mismo formato que escribe 'specify extension add'
|
|
281
469
|
printf '%s\n' 'installed:' '- orca' 'settings:' ' auto_execute_hooks: true' 'hooks:' ' before_implement:' ' - extension: orca' \
|
|
282
470
|
' command: speckit.orca.implement' ' enabled: true' ' optional: false' ' priority: 10' \
|
|
283
471
|
' description: "Orquestacion multiagente: reparte las user stories si compensa"' | write_file "$EXT"
|
|
284
|
-
|
|
472
|
+
item add "spec-kit: hook before_implement creado en .specify/extensions.yml"
|
|
285
473
|
else
|
|
286
|
-
warn "
|
|
474
|
+
item warn "spec-kit: hay extensions.yml y no está el comando specify"
|
|
475
|
+
todo "$PNAME: pide al agente «inicializa el proyecto» para añadir el hook de spec-kit sin romper tu extensions.yml."
|
|
287
476
|
fi
|
|
477
|
+
else
|
|
478
|
+
item keep "sin spec-kit (.specify/): no hace falta hook"
|
|
288
479
|
fi
|
|
289
480
|
if ! grep -qxF '.work/' "$PROJECT/.gitignore" 2>/dev/null; then
|
|
290
|
-
if [ "$DRY" -eq 1 ]; then
|
|
291
|
-
|
|
481
|
+
if [ "$DRY" -eq 1 ]; then item dry "añadir .work/ a .gitignore"; else printf '\n# Orca Multiagent Kit: briefs e informes de runs multiagente\n.work/\n' >> "$PROJECT/.gitignore"; fi
|
|
482
|
+
item add ".work/ añadido a .gitignore"
|
|
292
483
|
fi
|
|
293
|
-
|
|
484
|
+
done_phase
|
|
294
485
|
fi
|
|
295
486
|
|
|
296
|
-
[ -n "$
|
|
297
|
-
step "Hecho. Comprueba con: ./install.sh --verify · deshacer: ./install.sh --restore $STAMP"
|
|
487
|
+
if [ -n "$PROJECT" ] && [ "$PROJECT_ONLY" -eq 0 ]; then footer both; elif [ -n "$PROJECT" ]; then footer project; else footer global; fi
|
|
@@ -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.
|