From e8c15d9e92dbc88d4237e4e455e5d3f667f27602 Mon Sep 17 00:00:00 2001 From: Enmanuel Date: Sat, 11 Apr 2026 00:33:13 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20actualizar=20reglas=20y=20skills=20con?= =?UTF-8?q?=20el=20nuevo=20flujo=20autom=C3=A1tico=20(Paso=208)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - .claude/rules/create_agent.md: sección "Ruta rápida" actualizada con los flags de personalización y mención de personalize.sh standalone y detect-provider.sh para auto-detección de provider. - .claude/skills/create-agent/SKILL.md: Paso 2 reescrito para mostrar el comando completo con flags opcionales. Añadidas notas sobre personalize.sh y auto-detección de provider. - .claude/skills/create-bot/SKILL.md: Paso 3 actualizado para mencionar personalize.sh (robots: solo --description y --prefix aplican). Co-Authored-By: Claude Sonnet 4.6 --- .claude/rules/create_agent.md | 25 +++++++++++++++++++---- .claude/skills/create-agent/SKILL.md | 30 +++++++++++++++++++++------- .claude/skills/create-bot/SKILL.md | 11 +++++++++- 3 files changed, 54 insertions(+), 12 deletions(-) diff --git a/.claude/rules/create_agent.md b/.claude/rules/create_agent.md index 78ab36a..e20b158 100644 --- a/.claude/rules/create_agent.md +++ b/.claude/rules/create_agent.md @@ -62,16 +62,33 @@ Todo agente o robot creado debe pasar por TODOS estos pasos, en orden estricto: Si el usuario da todos los inputs, ir directo a la Ruta Rapida. Si faltan, preguntar antes de empezar. -## Ruta rapida — script automatizado (pasos 1-7) +## Ruta rapida — script automatizado (pasos 1-8) + +Si tienes todos los datos del agente (description + system prompt), el Paso 8 puede hacerse automaticamente: ```bash -./dev-scripts/agent/create-full.sh "Display Name" +./dev-scripts/agent/create-full.sh "Display Name" \ + --description "" \ + --provider \ + --system-prompt "" \ + [--tone ] \ + [--prefix ""] \ + [--tool-use] ``` -Este script ejecuta en orden: scaffold, build, register Matrix, verify E2EE, auto-avatar, display name, notify. +Este script ejecuta en orden: scaffold, build, register Matrix, verify E2EE, auto-avatar, display name, **personalizar (auto)**, notify. Crea todos los archivos, registra en el launcher, genera todas las env vars en `.env`. -Despues del script, personalizar los 3 archivos del agente (paso 8) y continuar con pasos 9-12. +**Si se omiten los flags de personalización**, el script se comporta como antes (pasos 1-7) y el Paso 8 queda pendiente de edición manual. + +**Personalización independiente** (sobre agente ya creado): +```bash +./dev-scripts/agent/personalize.sh --description "..." --system-prompt "..." +``` + +**Auto-detección de provider**: omitir `--provider` para que `detect-provider.sh` elija automáticamente según `.env`. + +Despues del script, continuar con pasos 9-12 (rebuild, start, health check, self-introduce). ## Archivos a personalizar despues del scaffold (paso 8) diff --git a/.claude/skills/create-agent/SKILL.md b/.claude/skills/create-agent/SKILL.md index 0944004..4cab75f 100644 --- a/.claude/skills/create-agent/SKILL.md +++ b/.claude/skills/create-agent/SKILL.md @@ -35,19 +35,27 @@ Si `$ARGUMENTS` contiene el agent-id, usarlo directamente: `$0` = agent-id, `$1` 3. Si faltan inputs, preguntar al usuario 4. Si `type` es `robot`, ignorar inputs de LLM/tools (no aplican) -### Paso 2: Ejecutar pipeline de scaffold +### Paso 2: Ejecutar pipeline — con personalización automática + +**Si tienes todos los inputs del usuario** (description + system prompt al menos), usa los flags para automatizar el Paso 8: Para **agentes** (con LLM): ```bash -./dev-scripts/agent/create-full.sh "" +./dev-scripts/agent/create-full.sh "" \ + --description "" \ + --provider \ + --system-prompt "" \ + [--tone ] \ + [--prefix ""] \ + [--tool-use] ``` -Para **robots** (command-only, sin LLM): +Para **robots** (command-only, sin LLM) — solo --description y --prefix aplican: ```bash -./dev-scripts/agent/create-full.sh "" --type robot +./dev-scripts/agent/create-full.sh "" --type robot ``` -El script ejecuta automaticamente los pasos 1-7 del pipeline formalizado: +El script ejecuta automaticamente los pasos 1-7 del pipeline formalizado, y si se pasan flags de personalización, también el **Paso 8 automático**: 1. **Scaffold**: copia `_template/`, personaliza archivos, actualiza launcher 2. **Build**: compila con `go build -tags goolm ./...` 3. **Register**: crea usuario Matrix, genera token + password + pickle key @@ -55,13 +63,21 @@ El script ejecuta automaticamente los pasos 1-7 del pipeline formalizado: 5. **(robots)** **Convert**: convierte a robot (config minimo, sin prompts, `command_prefix: ""`) 6. **Auto-avatar**: genera y aplica foto de perfil 7. **Display name**: configura nombre visible en Matrix -8. **Notify**: el propio bot envia DM de bienvenida a los devs (`DEVELOPER_MATRIX_USERS`) +8. **Personalize** (auto si se pasan flags): genera agent.go correcto, actualiza config.yaml y escribe system.md con sección de seguridad +9. **Notify**: el propio bot envia DM de bienvenida a los devs (`DEVELOPER_MATRIX_USERS`) Si alguna etapa falla, revisar el error y corregir antes de continuar. -**Pasos 8-12 (post-script)**: personalizar archivos, recompilar, arrancar, health check, self-introduce. +**Nota**: Si NO se pasan flags de personalización, el Paso 8 queda pendiente (edición manual). Ver `.claude/rules/create_agent.md` para el pipeline completo de 12 pasos. +**Personalización independiente**: `personalize.sh` se puede usar también sobre un agente ya creado: +```bash +./dev-scripts/agent/personalize.sh --description "..." --system-prompt "..." +``` + +**Auto-detección de provider**: si no se pasa `--provider`, `detect-provider.sh` elige automáticamente según las keys en `.env` (OPENAI_API_KEY → openai, ANTHROPIC_API_KEY → anthropic). + ### Paso 3: Personalizar agent.go Reemplazar el contenido de `agents//agent.go` segun el tipo: diff --git a/.claude/skills/create-bot/SKILL.md b/.claude/skills/create-bot/SKILL.md index 904ac26..e12c4cd 100644 --- a/.claude/skills/create-bot/SKILL.md +++ b/.claude/skills/create-bot/SKILL.md @@ -55,7 +55,16 @@ Pipeline completo (12 pasos): ver `.claude/rules/create_agent.md`. ### Paso 3: Personalizar config -Editar `agents//config.yaml`: +El Paso 8 (personalización) **no se automatiza para robots** (no tienen LLM/system prompt). +Solo editar `agents//config.yaml` para los 2 campos relevantes: + +```bash +./dev-scripts/agent/personalize.sh \ + --description "" \ + --prefix "" +``` + +O editar manualmente `agents//config.yaml`: - `agent.description`: la descripcion del usuario - `personality.prefix`: emoji representativo del bot (opcional)