Suporte upstream empacotado

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.

Vibe Delegate

Quando usar

• Você quer delegar uma tarefa de codificação limitada a um vibe implementador separado (Mistral Vibe) e, em seguida, revisar seu diff pessoalmente.
• O usuário solicitou explicitamente a delegação a este implementador.

Você é o orquestrador. Entregue uma tarefa de codificação limitada a um implementador separado — o Mistral Vibe CLI (vibe) — depois revise o que ele produziu e aplique as mudanças você mesmo. Você escreve o resumo e é responsável pelo julgamento; Vibe faz a digitação em sua própria sessão; 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.

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 vibe não está instalado ou autenticado.

Pré-requisitos (verificar uma vez)

1. Instale uv, depois Mistral Vibe:
   • uv tool install mistral-vibe
2. Configure sua chave de API com vibe --setup, ou defina MISTRAL_API_KEY no ambiente.
3. Confirme que vibe --version é bem-sucedido.
4. Trabalhe em, ou aponte --cd para, o repositório git de destino.

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

Vibe vê apenas o texto que você envia mais o que ele pode inspecionar no espaço de trabalho — sem histórico de chat ou contexto compartilhado. Inclua o objetivo, o estado atual, o que mudar, o que deixar intocado, os portões atuais do projeto e um contrato de relatório. Diga ao Vibe para não confirmar. Mantenha uma tarefa por resumo. Veja references/writing-the-brief.md.

O modo padrão não pode aprovar a maioria dos comandos de shell sem supervisão, então o orquestrador executa os portões. Peça ao Vibe para executá-los apenas quando o humano autorizou explicitamente --full-access.

2. Despache

Use o helper empacotado. Ele envolve o modo headless --prompt do Vibe, captura o fluxo de eventos estruturado 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
# limit turns for cost control:           add --max-turns <n>
# indicative price threshold/token cap:  add --max-price <usd> --max-tokens <n>
# planning/read-only:                     add --plan-only
# unrestricted shell and tools:           add --full-access (explicit authorization required)
# resume the most recent session:         add --resume-last  (delta brief only)
# resume a specific session:              add --session <id> (delta brief only)
# see all options:                        node .../relay.mjs --help

O cwd do processo filho fixa o espaço de trabalho. O relay escreve artefatos no diretório temporário do sistema por padrão e nunca confirma. Veja references/dispatch-and-poll.md.

3. Aguarde a conclusão

O helper bloqueia até que o Vibe termine. Execute-o com a instalação de comando em segundo plano do orquestrador, ou coloque-o em segundo plano no shell e verifique result.json. Um erro de uso pré-execução sai com código 2 e não escreve nenhum resultado; um vibe ausente sai com código 127 e escreve status: "vibe_unavailable". O watchdog escreve status: "timeout"; terminar o relay no POSIX escreve status: "aborted" após parar a árvore de processos do Vibe.

Confie no estado do processo e na árvore de trabalho em vez de uma exibição de progresso. Conclusão significa que o processo saiu e result.json existe.

4. Revise — não confie no autorrelato

Trate a mensagem final do Vibe e as alegações de portão como alegações:

• Reexecute os portões do projeto você mesmo.
• Leia o diff em relação ao resumo, começando com touchedFiles.
• Execute skills de guarda relevantes se instaladas.
• Execute migrações de ida e volta e procure por referências pendentes após remoções ou renomeações.

Veja references/review-and-land.md.

5. Aplique as mudanças

O implementador edita a árvore de trabalho; o orquestrador confirma. Confirme apenas após os portões serem aprovados e o diff estiver correto. Se for necessário refatorar, envie um resumo de delta com --resume-last ou --session <id>, então revise novamente.

Autonomia e permissões

No modo --prompt, o relay sempre define o perfil do agente explicitamente:

…