DETENTE. LEE ESTE SKILL.MD COMPLETO ANTES DE LLAMAR A CUALQUIER ENDPOINT.
Bandeja de Entrada de Agentes (Agent Inbox)
Mensajería entre agentes basada en archivos con despacho sin interfaz e integración con monitor de tareas.
Flujo de Trabajo Principal
- Enviar: El agente A envía un error/solicitud al proyecto B con modelo y comando de verificación
- Clasificar (Triage): La IA clasifica la gravedad, ajusta la prioridad/modelo, y lo enruta al proyecto
- Despachar: Se genera un agente sin interfaz con el modelo especificado para corregir el problema
- Rastrear: El monitor de tareas muestra el progreso en tiempo real (0% → 25% → 50% → 75% → 100%)
- Verificar: El comando de prueba se ejecuta antes del acuse automático; si falla, vuelve al agente
- Hilo: Respuestas e intercambios enhebrados para conversaciones de múltiples mensajes
Configuración
# Registrar proyectos (una vez)
.pi/skills/agent-inbox/agent-inbox register memory /home/user/workspace/memory
.pi/skills/agent-inbox/agent-inbox register scillm /home/user/workspace/litellm
# Listar / verificar
.pi/skills/agent-inbox/agent-inbox projects
.pi/skills/agent-inbox/agent-inbox whoami
Comandos
| Comando | Descripción |
|---|---|
register <nombre> <ruta> | Registrar un proyecto |
unregister <nombre> | Eliminar un proyecto |
projects [--json] | Listar proyectos registrados |
whoami | Mostrar el proyecto detectado para el directorio actual |
send --to PROYECTO --type TIPO "mensaje" | Enviar mensaje (tipos: bug, request, info, question) |
check [--project P] [--all] [--quiet] | Revisar bandeja de entrada |
list [--project P] [--status S] [--json] | Listar mensajes |
read ID_MSG [--json] | Leer un mensaje |
ack ID_MSG [--note "..."] | Acusar recibo/completar |
reply ID_MSG "mensaje" | Responder (enhebrado automático) |
thread ID_HILO | Ver el hilo completo de intercambios |
update-status ID_MSG ESTADO [--note] | Actualizar estado manualmente |
triage classify --message "..." [--no-llm] | Clasificación manual de triage |
triage route --message "..." | Enrutamiento automático por rutas de archivo |
triage log --msg-id ID | Ver registro de decisión de triage |
triage webhook-add --url URL --events E | Registrar webhook |
Opciones de Envío
| Opción | Descripción | Por Defecto |
|---|---|---|
--model MODELO | Modelo de IA: sonnet, opus-4.5, codex-5.2, codex-5.2-high | sonnet |
--timeout MINUTOS | Tiempo máximo de trabajo del agente | 30 |
--test COMANDO | Comando de verificación antes del acuse automático | Ninguno |
--no-dispatch | Deshabilitar generación automática | Falso |
--context-file ARCHIVO | Adjuntar archivo como contexto (repetible) | Ninguno |
--priority PRIORIDAD | low, normal, high, critical | normal |
--no-triage | Omitir clasificación de IA | Falso |
--dry-run | Mostrar JSON del mensaje sin enviar | Falso |
Selección de Modelo
| Modelo | Caso de Uso |
|---|---|
sonnet | Correcciones simples, errores tipográficos |
opus-4.5 | Análisis complejo, arquitectura |
codex-5.2 | Correcciones de errores estándar |
codex-5.2-high | Razonamiento profundo, condiciones de carrera |
Clasificación por IA (Triage)
Los mensajes se clasifican automáticamente por gravedad:
- critical: caída, pérdida de datos, seguridad, producción caída →
opus-4.5 - high: error, excepción, fallo, roto, regresión →
opus-4.5 - medium: bug, problema, incorrecto, inesperado →
sonnet - low: error tipográfico, cosmético, mejora, menor →
sonnet
El enrutamiento automático extrae rutas de archivo de los mensajes y las compara con los proyectos registrados.
Progresión de Estados
pending → dispatched (25%) → in_progress (50%) → needs_verification (75%) → done (100%)
Gancho Previo a Memoria (Pre-Hook)
El despachador consulta /memory antes de generar un agente para encontrar errores similares y soluciones previas.
Verificación Proactiva
Los agentes deben revisar la bandeja de entrada al inicio de la sesión, al cambiar de proyecto, antes de un trabajo importante, y cuando los usuarios mencionan a otro agente o proyecto.
Almacenamiento
~/.agent-inbox/
├── pending/ # Mensajes no procesados
├── done/ # Mensajes acusados
├── logs/ # Registros de despacho
├── task_states/ # Archivos de estado del monitor de tareas
├── triage_logs/ # Registros de decisiones de clasificación de IA
├── webhooks.json # Webhooks registrados
└── projects.json # Registro de proyectos
Ejemplos
# Enviar error con verificación (genera agente Opus sin interfaz, acusa automáticamente si la prueba pasa)
python inbox.py send --to scillm --type bug --model opus-4.5 \
--test "pytest tests/test_providers.py -x" \
"Condición de carrera en la inicialización del proveedor"
# Adjuntar archivos de contexto
python inbox.py send --to scillm --type bug --model opus-4.5 \
--context-file src/server.py --context-file /tmp/traceback.txt \
"Caída del servidor al iniciar"
# Revisar y procesar bandeja de entrada
python inbox.py check --all
python inbox.py read scillm_abc123
python inbox.py ack scillm_abc123 --note "Corregido en commit abc123"
# Intercambio enhebrado
python inbox.py reply scillm_abc123 "¿Puedes proporcionar el traceback?"
python inbox.py thread scillm_abc123
Demonio de Despacho
python dispatcher.py start # En segundo plano
python dispatcher.py start --foreground # Depuración
python dispatcher.py status
python dispatcher.py stop
Variables de Entorno
| Variable | Descripción | Por Defecto |
|---|---|---|
AGENT_INBOX_DIR | Directorio de la bandeja de entrada | ~/.agent-inbox |
TASK_MONITOR_API_URL | URL del monitor de tareas | http://localhost:8765 |
CLAUDE_PROJECT | Nombre del proyecto actual | detectado automáticamente |
Integración con Hooks de Claude Code
{
"hooks": {
"on_session_start": [
".pi/skills/agent-inbox/agent-inbox check --project $(basename $PWD) || true"
]
}
}