docs: actualizar skills y CLAUDE.md con pipeline formalizado

- /create-agent SKILL.md: pipeline 8 pasos del script, pasos 8-12 post
- /create-bot SKILL.md: pipeline con health check y self-introduce
- CLAUDE.md: seccion breve de pipeline de 12 pasos con env var clave

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-09 22:46:29 +00:00
parent 9cad643c23
commit c6eae2fcae
3 changed files with 56 additions and 15 deletions
+20 -8
View File
@@ -40,15 +40,18 @@ Si `$ARGUMENTS` contiene el bot-id, usarlo directamente: `$0` = bot-id, `$1` = d
./dev-scripts/agent/create-full.sh <bot-id> "<display-name>" --type robot
```
Este script ejecuta 6 etapas automaticamente:
Este script ejecuta los pasos 1-7 del pipeline formalizado:
1. **Scaffold**: crea agent.go, config.yaml, prompts/ desde template
2. **Build**: verifica compilacion con `-tags goolm`
3. **Register**: registra usuario Matrix, genera token + password + pickle key
4. **Verify E2EE**: genera cross-signing keys + recovery key
5. **Convert**: convierte a robot (config minimo, sin prompts, sin LLM, `command_prefix: ""`)
6. **Notify**: envia DM a los developers (DEVELOPER_MATRIX_USERS) presentandose
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
Si alguna etapa falla, revisar el error y corregir antes de continuar.
Pipeline completo (12 pasos): ver `.claude/rules/create_agent.md`.
### Paso 3: Personalizar config
@@ -113,7 +116,16 @@ go build -tags goolm ./...
Si falla, corregir y reintentar.
### Paso 6: Checklist final
### Paso 6: Arrancar + health check + self-introduce (pasos 9-12)
```bash
go build -tags goolm ./...
./dev-scripts/server/start.sh # o restart.sh
./dev-scripts/agent/health-check.sh <bot-id>
./dev-scripts/agent/notify-developer.sh <bot-id> robot "<display-name>"
```
### Paso 7: Checklist final
Verificar y reportar al usuario:
@@ -121,20 +133,20 @@ Verificar y reportar al usuario:
- [ ] `agents/<id>/agent.go` exporta `Rules()` que retorna `nil`
- [ ] `agents/<id>/config.yaml` tiene `agent.type: robot` y `agent.id` coincide con directorio
- [ ] `cmd/launcher/main.go` tiene import del paquete del bot
- [ ] `.env` contiene las 4 env vars: `MATRIX_TOKEN_<NORM>`, `MATRIX_PASSWORD_<NORM>`, `PICKLE_KEY_<NORM>`, `SSSS_RECOVERY_KEY_<NORM>`
- [ ] `.env` contiene las 4 env vars
- [ ] No existe `agents/<id>/prompts/` (robots no necesitan system prompt)
- [ ] Si tiene comandos custom, estan registrados en el launcher
- [ ] Health check pasa
- [ ] Bot envio bienvenida a los devs
Informar al usuario:
```
Robot <bot-id> creado. Para arrancar:
./dev-scripts/server/start.sh
Robot <bot-id> creado y activo.
Comandos built-in: help, ping, status, info, version
Comandos custom: <lista si hay>
(Sin prefijo ! — el robot acepta comandos directamente)
Archivos a revisar:
Archivos:
agents/<bot-id>/config.yaml — configuracion
agents/<bot-id>/commands.go — comandos custom (si aplica)
```