Delegando para Agentes

Quando Usar

• Use apenas quando o usuário ou as instruções atuais aplicáveis autorizarem explicitamente a delegação; passe trabalho delimitado com contexto completo, propriedade de arquivos e um verificador.
• Use quando precisar repassar instruções para agentes de terminal ou TUI sem perder o contexto.

Selecionando um Agente Autorizado

• Use o agente/modelo selecionado pelo usuário e as ferramentas disponíveis; limites de conta e capacidades do modelo exigem evidências atuais.
• Combine uma tarefa delimitada com ferramentas reais e propriedade de arquivos, não com "uso ilimitado" inventado ou rankings universais de modelos.
• Mantenha a integração e a validação final com o principal. Relate arquivos alterados, verificações exatas e problemas restantes.

Enviando Prompts para um Agente TUI

1. Prefira uma API de agente/tarefa estruturada em vez de simular digitação no terminal; forneça um prompt legível, limite de propriedade, verificador e não-metas.
2. Se apenas um TUI estiver disponível, inspecione a superfície de destino e a documentação do comando real primeiro. Coloque prompts longos em um arquivo de tarefa explicitamente autorizado e envie uma referência curta sem incorporar texto de tarefa arbitrário em um comando shell.
3. Um prompt entre aspas de shell pode executar $(), backticks ou expansões se escapado incorretamente. Preserve a pontuação/conteúdo usando argv estruturado ou aspas de shell adequadas; não "corrija" mensagens removendo apóstrofos ou interpretando seu texto como comandos.
4. Confirme uma submissão pretendida e o destinatário real; a saída do terminal/rascunhos previstos não são autorização humana para mensagens adicionais.

Sondagem (Polling)

Use esperas de conclusão/evento suportadas com intervalos limitados; verifique o progresso significativo e entregue atualizações concisas. Não faça sondagem ativa a cada 3–5 segundos nem relate estado inalterado após cada verificação. Recue enquanto um agente permanecer ativo e continue o trabalho independente autorizado. Nota do Claude Code: após terminar, ele pode pré-preencher uma mensagem de usuário prevista — esse rascunho é do Claude, não do usuário.

VPS Remoto

A execução remota requer autorização para o host/projeto exato e o limite de credenciais. Use a configuração de sandbox/aprovação suportada; não inicie um agente irrestrito nem infira acesso remoto de uma solicitação de delegação.

Os 4 Agentes (Referência de Fundo)

Todos os quatro usam o padrão portátil SKILL.md; as habilidades do projeto prevalecem sobre as globais.

• Pi (pi.dev, TS de código aberto): núcleo mínimo de leitura/escrita/edição/bash, auto-estende-se via extensões TS; BYOK verdadeiro; melhor em sua classe para ramificação/fork/retomada de sessão. Habilidades: ~/.pi/agent/skills/.
• Codex CLI (OpenAI, Rust): inicialização mais rápida; sandboxing em nível de kernel; codex exec para CI; lê AGENTS.md. Habilidades: ~/.codex/skills/.
• Claude Code (Anthropic, TS): integração mais profunda com Claude, convenções .claude/, recarga a quente de habilidades ao vivo. Habilidades: ~/.claude/skills/.
• Hermes (Nous Research, Python): agente autônomo persistente — memória entre sessões, agendador embutido, mais de 40 ferramentas; pode orquestrar os outros CLIs como trabalhadores. Habilidades: ~/.hermes/skills/.

Dirigindo CLIs Interativas

• Codex, Pi, OpenCode: precisam de pty=true.
• Claude Code: use seu modo não interativo suportado com a política de permissão existente; nunca habilite bypassPermissions apenas para dirigir o CLI.

Exemplo

Solicitação do usuário:

Delegue estes itens de trabalho independentes com contexto completo, propriedade clara e verificações de progresso.

Limitações

• Adaptado de davidondrej/skills; verifique caminhos locais, ferramentas, credenciais e recursos do agente antes de agir.
• Para comandos, acesso remoto, agendamento, automação de navegador ou fluxos de trabalho de alteração de arquivos, obtenha aprovação explícita do usuário e confirme o ambiente de destino primeiro.