docs: actualizar reglas y skills con el nuevo flujo automático (Paso 8)
- .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 <noreply@anthropic.com>
This commit is contained in:
@@ -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 <agent-id> "Display Name"
|
||||
./dev-scripts/agent/create-full.sh <agent-id> "Display Name" \
|
||||
--description "<descripcion>" \
|
||||
--provider <openai|anthropic> \
|
||||
--system-prompt "<system prompt con seccion de seguridad>" \
|
||||
[--tone <friendly|professional|casual|technical>] \
|
||||
[--prefix "<emoji>"] \
|
||||
[--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 <agent-id> --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)
|
||||
|
||||
|
||||
@@ -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 <agent-id> "<display-name>"
|
||||
./dev-scripts/agent/create-full.sh <agent-id> "<display-name>" \
|
||||
--description "<descripcion>" \
|
||||
--provider <openai|anthropic> \
|
||||
--system-prompt "<system prompt completo con seccion de seguridad>" \
|
||||
[--tone <friendly|professional|casual|technical>] \
|
||||
[--prefix "<emoji>"] \
|
||||
[--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 <agent-id> "<display-name>" --type robot
|
||||
./dev-scripts/agent/create-full.sh <bot-id> "<display-name>" --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 <agent-id> --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-id>/agent.go` segun el tipo:
|
||||
|
||||
@@ -55,7 +55,16 @@ Pipeline completo (12 pasos): ver `.claude/rules/create_agent.md`.
|
||||
|
||||
### Paso 3: Personalizar config
|
||||
|
||||
Editar `agents/<bot-id>/config.yaml`:
|
||||
El Paso 8 (personalización) **no se automatiza para robots** (no tienen LLM/system prompt).
|
||||
Solo editar `agents/<bot-id>/config.yaml` para los 2 campos relevantes:
|
||||
|
||||
```bash
|
||||
./dev-scripts/agent/personalize.sh <bot-id> \
|
||||
--description "<descripcion>" \
|
||||
--prefix "<emoji>"
|
||||
```
|
||||
|
||||
O editar manualmente `agents/<bot-id>/config.yaml`:
|
||||
- `agent.description`: la descripcion del usuario
|
||||
- `personality.prefix`: emoji representativo del bot (opcional)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user