Suporte upstream incluído

Arquivos de suporte são incluídos em caminhos relativos à skill. Veja UPSTREAM-NOTICE.md para suas fontes fixadas, licenças, hashes e alterações de importação.

Warp Delegate

Quando Usar

• Você quer delegar uma tarefa de codificação limitada a um warp implementador separado (Warp Agent CLI) e depois revisar seu diff pessoalmente.
• O usuário pediu explicitamente a delegação para este implementador.

Você é o orquestrador. Delegue uma tarefa de codificação limitada a um implementador separado - o Warp Agent CLI - depois revise o que ele produziu e integre-o você mesmo. Você escreve o resumo e assume o julgamento; o implementador faz as alterações em sua própria conversa; você verifica e confirma.

O loop precisa apenas de um comando de shell e acesso a arquivos, então qualquer orquestrador comparável pode controlá-lo.

O binário é oz, não warp

O Warp distribui dois programas diferentes, e apenas um deles pode ser delegado:

• oz - o Warp Agent CLI. Sem interface gráfica e scriptável; oz agent run executa um agente contra um diretório local. É isso que o relay controla.
• warp - o Warp TUI interativo. Requer um dispositivo de terminal, não tem prompt ou flag de impressão (suas únicas opções são --resume, --auto-approve, --api-key e os comandos de chave do provedor), e sai com Device not configured quando o stdin é um pipe. Não pode ser relayado.

Se oz estiver faltando, mas warp estiver instalado, você tem o TUI, não o CLI.

Quando NÃO usar isto

• A tarefa é pequena o suficiente para ser feita inline; o overhead da delegação não vale a pena.
• O CLI oz não está instalado ou autenticado.
• Você precisa de um implementador em sandbox ou somente leitura. oz agent run não tem sandbox, modo de permissão nem execução somente leitura - veja Autonomia e permissões.
• O trabalho deve permanecer fora dos servidores do Warp. oz agent run carrega um snapshot do workspace ao final da execução a menos que --no-snapshot seja passado, e as conversas vivem no lado do servidor.

Pré-requisitos (verificar uma vez)

1. Instale o Warp Agent CLI - veja https://docs.warp.dev/cli/.
2. Autentique: oz login, ou defina WARP_API_KEY para CI, um contêiner ou qualquer host sem interface gráfica.
3. Confirme que a conta tem cota de IA. Um login funcional não é suficiente - ao contrário dos outros CLIs neste pacote. oz whoami pode ter sucesso enquanto cada despacho falha com In order to use Warp's AI features, subscribe to a Warp plan, or bring your own inference. O Warp registra isso internamente como QuotaLimit / "falta de cota de IA", então é uma condição de crédito na conta em vez de um direito específico do CLI: oz executa o mesmo harness de agente que o aplicativo Warp e utiliza a mesma conta, plano e créditos. Verifique se oz whoami nomeia a conta que detém o plano - se não o fizer, oz logout && oz login o corrige. Caso contrário, confirme que os créditos de IA do plano não foram gastos, ou armazene sua própria chave de provedor - warp --set-provider-api-key <openai|anthropic|google|grok>, ou /api-keys dentro do TUI. O "traga sua própria chave" não precisa de um plano Warp pago.
4. Confirme que oz --version tem sucesso e oz whoami imprime seu usuário.
5. Trabalhe em, ou aponte --cd para, o repositório git alvo.

No macOS, o CLI é distribuído como um binário com assinatura de Developer ID; uma primeira execução pode ser retida pelo Gatekeeper até ser aprovada.

Escolha o modelo (opcional)

Omita --model para usar o padrão configurado do Warp. Para escolher outro, selecione um ID de oz model list e passe-o literalmente. O relay aceita apenas letras, dígitos e . _ : / -, então um valor não pode ser confundido com outro flag oz.

O loop

Execute estas cinco etapas por tarefa. As etapas 1, 4 e 5 exigem julgamento; 2 e 3 são mecânicas.

1. Escreva o resumo

O Warp vê apenas o texto que você envia mais o que ele pode inspecionar no workspace - sem histórico de chat ou contexto compartilhado. Inclua o objetivo, estado atual, o que mudar, o que não tocar, os portões reais do projeto e um contrato de relatório. Diga para não commitar. Mantenha uma tarefa por resumo. O resumo é entregue como o valor --prompt em argv, então é visível na lista de processos do host - mantenha segredos fora dele e referencie arquivos do workspace em vez disso. Veja references/writing-the-brief.md.

2. Despache

Use o relay incluído. Ele executa oz agent run --output-format ndjson, captura o fluxo de eventos e escreve result.json. (<skill-dir> é a pasta instalada contendo este SKILL.md.)

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo

…