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.

Qoder Delegate

Quando Usar

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

Você é o orquestrador. Delegue uma tarefa de codificação delimitada para um implementador separado - Qoder CLI - então revise o que ele produziu e aplique as mudanças você mesmo. Você escreve o resumo e assume o julgamento; Qoder edita a árvore de trabalho em sua sessão; você verifica e confirma.

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

Quando NÃO usar isso

• A tarefa é pequena o suficiente para ser feita inline; o overhead de delegação não vale a pena.
• qodercli não está instalado ou autenticado.
• Você quer escrever o código você mesmo ou precisa apenas de uma sessão interativa do Qoder.

Pré-requisitos (verificar uma vez)

command -v qodercli
qodercli --version
qodercli --list-models

Se o binário estiver faltando, instale-o do Guia Rápido oficial do Qoder. Autentique com qodercli login, ou defina QODER_PERSONAL_ACCESS_TOKEN para automação. Um --list-models bem-sucedido confirma que a conta atual pode retornar seu catálogo de modelos ao vivo.

Escolher modelo e janela de contexto

Os modelos disponíveis do Qoder podem mudar. Se o humano solicitar um modelo, use seu valor exato atual de qodercli --list-models; nunca invente ou fixe uma entrada de catálogo. Caso contrário, omita --model e deixe o Qoder usar seu padrão atual.

--context-window <n> é opcional. Passe um número inteiro positivo apenas quando o humano solicitar um tamanho ou a tarefa precisar de um orçamento explícito. O Qoder o aplica apenas a modelos suportados; apresente um erro de modelo/tamanho não suportado em vez de escolher silenciosamente outro valor.

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 Qoder vê o resumo mais o que ele pode inspecionar no espaço de trabalho, não este chat. Inclua o objetivo, o estado atual, o que mudar, o que não tocar, os portões reais do projeto e um contrato de relatório final. Diga ao Qoder para não confirmar. Mantenha uma tarefa por resumo. Veja references/writing-the-brief.md.

2. Despachar

Use o relay empacotado. Ele envolve o modo stream-json não interativo do Qoder 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
# choose a live model:                 add --model "<value from qodercli --list-models>"
# request a supported context window: add --context-window 32768
# resume the latest session:          add --resume-last  # delta brief only
# resume a specific session:          add --resume <id>  # delta brief only
# see every option:                   node .../relay.mjs --help

As implementações rodam com o modo de permissão auto padrão do Qoder. O relay nunca ignora permissões a menos que o chamador solicite explicitamente, e nunca confirma. Veja references/dispatch-and-poll.md.

3. Aguardar a conclusão

O relay bloqueia até o Qoder sair. Execute-o com o recurso de comando em segundo plano do orquestrador, ou coloque-o em segundo plano no shell e espere por result.json. A conclusão significa que o processo saiu e o arquivo contém um status; não confie em uma exibição de progresso.

Um erro de uso pré-execução sai com código 2 e não escreve resultado. A falta de qodercli sai com código 127 e escreve status: "qoder_unavailable" com orientação de instalação.

O lançamento nativo do relay no Windows ainda não foi verificado; não o reivindique até que um teste de fumaça nativo no Windows passe.

4. Revisar - não confie no auto-relato

Trate a mensagem final do Qoder e os resultados dos portões como alegações:

• Re-execute os portões do projeto você mesmo.
• Leia o diff em relação ao resumo, começando por touchedFiles.
• Verifique quaisquer --add-dir workspaces separadamente; suas alterações não estão no relatório principal da árvore.
• Execute skills de guarda relevantes, se instaladas.
• Migrações de ida e volta e grep por referências pendentes após remoções ou renomeações.

Veja references/review-and-land.md.

5. Aplicar as mudanças

O implementador edita; o orquestrador confirma. Confirme apenas após os portões passarem e o diff

…