Copilot Delegate

Quando Usar

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

Você é o orquestrador. Delegue uma tarefa de codificação delimitada a um implementador separado — o GitHub Copilot CLI — depois revise o que ele produziu e aplique as mudanças você mesmo. Você escreve o resumo 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 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

• A tarefa é pequena o suficiente para ser feita inline; o overhead da delegação não vale a pena.
• O CLI copilot não está instalado ou autenticado.
• Você precisa de um sandbox rígido. O Copilot expõe controles de sandbox, mas eles são experimentais (baseados em MXC, controlados via comando /sandbox e configurações, desativados por padrão) — este relay não os configura. --read-only apenas desabilita ferramentas de edição (--mode plan); comandos de shell ainda são executados. Se os arquivos do projeto não devem ser alterados de forma alguma, envie a tarefa para uma árvore de trabalho limpa ou isolada.

Pré-requisitos (verificar uma vez)

1. Instale copilot (npm install -g @github/copilot; o CLI requer Node 22+, o relay em si roda em Node 18+ — o relay sonda copilot version).
2. Autentique: execute copilot login (fluxo interativo web/dispositivo), ou defina COPILOT_GITHUB_TOKEN / GH_TOKEN / GITHUB_TOKEN no ambiente.
3. Confirme que copilot version é bem-sucedido.
4. Trabalhe em, ou aponte --cd para, o repositório git alvo.

Escolher o modelo (opcional)

O Copilot escolhe um modelo padrão (auto). Para escolher outro, passe --model <name>. O relay aceita apenas letras, dígitos e . _ : / - (o valor chega a um shell no Windows).

Escolher o esforço (opcional)

O Copilot suporta um controle de esforço de raciocínio: --effort <level> com valores low, medium, high, xhigh, ou max. O relay rejeita qualquer outro valor antes do envio.

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 resumo

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

2. Enviar

Use o relay empacotado. Ele executa copilot -p com --output-format json --no-color --stream off, captura o fluxo de eventos JSONL e escreve result.json.

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# choose a model:                    add --model <name>
# set reasoning effort:              add --effort <level>
# read-only planning pass:           add --read-only  (forces --mode plan)
# full tool autonomy:                add --allow-all-tools
# hard time limit (watchdog):        add --timeout 2h   (the 30m default suits brief runs)
# resume a session:                  add --session <id>  or  --resume-last
# 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 confirma. Veja references/dispatch-and-poll.md.

3. Aguardar a conclusão

O relay bloqueia até que o copilot 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 copilot ausente sai com código 127 e escreve status: "copilot_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 assistente do Copilot é o campo finalMessage de result.json.

4. Revisar — não confie no auto-relatório

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

Veja references/review-and-land.md.

5. Aplicar

Se o trabalho estiver bom, confirme-o. O relay nunca confirma — 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

…