PARE. LEIA ESTE SKILL.MD COMPLETO ANTES DE CHAMAR QUALQUER ENDPOINT.
Agent Inbox
Mensagens entre agentes baseadas em arquivos com despacho headless e integração com task-monitor.
Fluxo de Trabalho Principal
- Enviar: Agente A envia bug/solicitação para o projeto B com modelo + comando de verificação
- Triagem: IA classifica a severidade, ajusta prioridade/modelo, roteia para o projeto
- Despachar: Agente headless é gerado com o modelo especificado para corrigir o problema
- Acompanhar: Task-monitor mostra progresso em tempo real (0% → 25% → 50% → 75% → 100%)
- Verificar: Comando de teste é executado antes do auto-ack — falhas retornam ao agente
- Thread: Encadeamento de respostas/trocas para conversas com múltiplas mensagens
Configuração
# Registrar projetos (uma 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 | Descrição |
|---|---|
register <nome> <caminho> | Registrar um projeto |
unregister <nome> | Remover um projeto |
projects [--json] | Listar projetos registrados |
whoami | Mostrar projeto detectado para o diretório atual |
send --to PROJETO --type TIPO "msg" | Enviar mensagem (tipos: bug, request, info, question) |
check [--project P] [--all] [--quiet] | Verificar caixa de entrada |
list [--project P] [--status S] [--json] | Listar mensagens |
read ID_MSG [--json] | Ler uma mensagem |
ack ID_MSG [--note "..."] | Confirmar/completar |
reply ID_MSG "msg" | Responder (thread automática) |
thread ID_THREAD | Ver thread completa de trocas |
update-status ID_MSG STATUS [--note] | Atualizar status manualmente |
triage classify --message "..." [--no-llm] | Classificação manual de triagem |
triage route --message "..." | Roteamento automático por caminhos de arquivo |
triage log --msg-id ID | Ver registro de decisão de triagem |
triage webhook-add --url URL --events E | Registrar webhook |
Opções de Envio
| Opção | Descrição | Padrão |
|---|---|---|
--model MODELO | Modelo de IA: sonnet, opus-4.5, codex-5.2, codex-5.2-high | sonnet |
--timeout MINUTOS | Tempo máximo de trabalho do agente | 30 |
--test COMANDO | Comando de verificação antes do auto-ack | Nenhum |
--no-dispatch | Desabilitar auto-spawn | False |
--context-file ARQUIVO | Anexar arquivo como contexto (repetível) | Nenhum |
--priority PRIORIDADE | low, normal, high, critical | normal |
--no-triage | Pular triagem de IA | False |
--dry-run | Mostrar JSON da mensagem sem enviar | False |
Seleção de Modelo
| Modelo | Caso de Uso |
|---|---|
sonnet | Correções simples, erros de digitação |
opus-4.5 | Análise complexa, arquitetura |
codex-5.2 | Correções de bugs padrão |
codex-5.2-high | Raciocínio profundo, condições de corrida |
Triagem de IA
As mensagens são classificadas automaticamente por severidade:
- critical: falha, perda de dados, segurança, produção fora do ar →
opus-4.5 - high: erro, exceção, falha, quebrado, regressão →
opus-4.5 - medium: bug, problema, incorreto, inesperado →
sonnet - low: erro de digitação, cosmético, melhoria, menor →
sonnet
O roteamento automático extrai caminhos de arquivo das mensagens e os combina com projetos registrados.
Progressão de Status
pending → dispatched (25%) → in_progress (50%) → needs_verification (75%) → done (100%)
Pré-Hook de Memória
O despachante consulta /memory antes de gerar para encontrar bugs semelhantes e soluções anteriores.
Verificação Proativa
Agentes devem verificar a caixa de entrada no início da sessão, ao trocar de projetos, antes de trabalhos importantes, e quando usuários mencionarem outro agente ou projeto.
Armazenamento
~/.agent-inbox/
├── pending/ # Mensagens não processadas
├── done/ # Mensagens confirmadas
├── logs/ # Registros de despacho
├── task_states/ # Arquivos de estado do task-monitor
├── triage_logs/ # Registros de decisão de triagem de IA
├── webhooks.json # Webhooks registrados
└── projects.json # Registro de projetos
Exemplos
# Enviar bug com verificação (gera agente Opus headless, auto-ack se o teste passar)
python inbox.py send --to scillm --type bug --model opus-4.5 \
--test "pytest tests/test_providers.py -x" \
"Condição de corrida na inicialização do provider"
# Anexar arquivos de contexto
python inbox.py send --to scillm --type bug --model opus-4.5 \
--context-file src/server.py --context-file /tmp/traceback.txt \
"Falha no servidor ao iniciar"
# Verificar e processar caixa de entrada
python inbox.py check --all
python inbox.py read scillm_abc123
python inbox.py ack scillm_abc123 --note "Corrigido no commit abc123"
# Troca encadeada
python inbox.py reply scillm_abc123 "Você pode fornecer o stack trace?"
python inbox.py thread scillm_abc123
Daemon do Despachante
python dispatcher.py start # Background
python dispatcher.py start --foreground # Debug
python dispatcher.py status
python dispatcher.py stop
Variáveis de Ambiente
| Variável | Descrição | Padrão |
|---|---|---|
AGENT_INBOX_DIR | Diretório da caixa de entrada | ~/.agent-inbox |
TASK_MONITOR_API_URL | URL do task-monitor | http://localhost:8765 |
CLAUDE_PROJECT | Nome do projeto atual | auto-detectado |
Integração com Hooks do Claude Code
{
"hooks": {
"on_session_start": [
".pi/skills/agent-inbox/agent-inbox check --project $(basename $PWD) || true"
]
}
}