Cline Delegate

Quando Usar

• Você quer delegar uma tarefa de codificação delimitada para um implementador cline separado (Cline) e, em seguida, revisar o diff dele.
• O usuário pediu explicitamente a delegação para este implementador.

Você é o orquestrador. Delegue uma tarefa de codificação delimitada a um implementador separado - o agente de codificação Cline CLI - depois revise o que ele produziu e integre-o você mesmo. Você escreve o briefing e assume o julgamento; o implementador faz as alterações em sua própria sessão em uma árvore de trabalho limpa; você verifica e commita.

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

• A tarefa é pequena o suficiente para ser feita inline; o overhead da delegação não vale a pena.
• O CLI cline não está instalado ou autenticado.
• Você precisa que o relay configure um sandbox. O Cline expõe controles de sandbox, mas este relay os deixa para o ambiente do CLI; use --plan quando a execução precisar ser somente leitura.

Pré-requisitos (verificar uma vez)

1. Instale cline (npm ou binário empacotado; o relay sonda cline --version).
2. Autentique: execute cline auth (login interativo) ou configure ANTHROPIC_API_KEY / uma URL base compatível com OpenAI.
3. Confirme que cline --version é bem-sucedido.
4. Trabalhe em, ou aponte --cd para, o repositório git alvo.

Escolher o Modelo (opcional)

O Cline escolhe um modelo padrão. Para escolher outro, passe o --model <id> ou --provider <name> separado (por exemplo, anthropic, openai-native, openrouter). O relay aceita apenas letras, dígitos e . _ : / - (o valor chega a um shell no Windows).

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 um Briefing

O Cline vê apenas o texto que você envia. Ele não pode ler sua conversa: o briefing deve ser autossuficiente com o objetivo, estado atual, o que mudar, o que deixar intocado, os portões reais do projeto e um contrato de relatório. Mantenha cada briefing para uma única tarefa. Escreva-o em um arquivo e passe-o como --brief do relay. Veja references/writing-the-brief.md.

2. Despacho

Use o relay empacotado. Ele executa cline --json -v, transmite o briefing via stdin por trás de uma instrução posicional fixa, captura o fluxo de eventos JSON e escreve result.json.

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# choose a model / provider:        add --model <id>  --provider <name>
# read-only planning pass:          add --plan   (forces --auto-approve false)
# deny approval-required tools:     add --auto-approve false
# hard time limit (watchdog):        add --timeout 2h   (the 30m default suits brief runs; most implementation briefs should be 1-2h)
# see all options:                   node .../relay.mjs --help

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

3. Aguarde a Conclusão

O relay bloqueia até que o cline termine. Execute-o com a instalação de comando em segundo plano do orquestrador, ou coloque-o em segundo plano no shell e consulte result.json. Um erro de uso pré-execução sai com código 2 e não escreve resultado; um cline ausente sai com código 127 e escreve status: "cline_unavailable".

Conclusão significa que o processo terminou e result.json existe - confie no estado do processo e na árvore de trabalho, não na exibição de progresso. A mensagem final do Cline é o campo finalMessage de result.json.

4. Revisão - Não Confie no Auto-Relato

• Reexecute os portões do projeto você mesmo.
• Leia o diff em relação ao briefing, começando com touchedFiles.
• Execute habilidades de guarda relevantes se instaladas.

Veja references/review-and-land.md.

5. Integre

Se o trabalho estiver bom, commite-o. O relay nunca commita - o diff e result.json são o registro; execute git status e git diff primeiro para confirmar exatamente o que mudou. Se o grupo tiver um fluxo de PR, faça o commit e envie um branch; deixe a revisão humana acontecer. Se o diff estiver errado ou incompleto, despache novamente um briefing corrigido em uma nova execução e revise novamente.

Autonomia e Permissões

O relay passa explicitamente o --auto-approve do Cline, com padrão para true no modo de ação. O modo de plano do Cline pode solicitar uma mudança para o modo de ação, então --plan força --auto-approve false; o relay rejeita --plan --auto-approve true. Esse par é o portão somente leitura. O Cline também expõe sandbox

…