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
+30 -7
View File
@@ -47,16 +47,21 @@ Para **robots** (command-only, sin LLM):
./dev-scripts/agent/create-full.sh <agent-id> "<display-name>" --type robot
```
El script ejecuta automaticamente:
El script ejecuta automaticamente los pasos 1-7 del pipeline formalizado:
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
4. **Verify E2EE**: genera cross-signing keys, recovery key
5. **(robots)** **Convert**: convierte a robot (config minimo, sin prompts, `command_prefix: ""`)
6. **Notify**: envia DM a los developers (`DEVELOPER_MATRIX_USERS` en `.env`) 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 (`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.
Ver `.claude/rules/create_agent.md` para el pipeline completo de 12 pasos.
### Paso 3: Personalizar agent.go
Reemplazar el contenido de `agents/<agent-id>/agent.go` segun el tipo:
@@ -134,24 +139,42 @@ go build -tags goolm ./...
Si falla, corregir el error y reintentar.
### Paso 7: Checklist final
### Paso 7: Rebuild + arranque (pasos 9-10)
```bash
go build -tags goolm ./...
./dev-scripts/server/start.sh # o restart.sh si ya esta corriendo
```
### Paso 8: Health check + self-introduce (pasos 11-12)
```bash
./dev-scripts/agent/health-check.sh <agent-id>
./dev-scripts/agent/notify-developer.sh <agent-id> <type> "<display-name>"
```
El health check verifica que el bot arranco (busca `"runner started"` en logs).
El notify hace que el propio bot envie DM de bienvenida a los devs.
### Paso 9: Checklist final
Verificar y reportar al usuario:
- [ ] `go build -tags goolm ./...` compila sin errores
- [ ] `agents/<id>/agent.go` exporta `Rules()` y es puro (sin I/O)
- [ ] `agents/<id>/config.yaml` tiene `agent.id` coincidiendo con el directorio
- [ ] `cmd/launcher/main.go` tiene import + rulesRegistry con el mismo ID
- [ ] `cmd/launcher/main.go` tiene blank import del paquete del agente
- [ ] `.env` contiene las 4 env vars: `MATRIX_TOKEN_<NORM>`, `MATRIX_PASSWORD_<NORM>`, `PICKLE_KEY_<NORM>`, `SSSS_RECOVERY_KEY_<NORM>`
- [ ] `prompts/system.md` tiene contenido real y seccion de seguridad
- [ ] Si `tool_use.enabled: true`, el prompt menciona las tools
- [ ] Health check pasa
- [ ] Bot envio bienvenida a los devs (o `DEVELOPER_MATRIX_USERS` no configurado)
Informar al usuario:
```
Agente <agent-id> creado. Para arrancar:
./dev-scripts/server/start.sh
Agente <agent-id> creado y activo.
Archivos a revisar:
Archivos:
agents/<agent-id>/agent.go — reglas
agents/<agent-id>/config.yaml — configuracion
agents/<agent-id>/prompts/system.md — system prompt