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.

ZCode Delegate

Quando Usar

• Você quer delegar uma tarefa de codificação limitada a um implementador zcode separado (Z.AI ZCode) e, em seguida, revisar o diff gerado por conta própria.
• O usuário pediu explicitamente a delegação para este implementador.

Você é o orquestrador. Esta skill permite que você entregue uma tarefa de codificação limitada a um implementador separado — o Z.AI ZCode CLI — e, em seguida, revise o que ele produziu e o integre você mesmo. Você escreve o briefing e é o responsável pelo julgamento; ZCode faz a digitação; você verifica e confirma.

Nada aqui é específico para um agente orquestrador. O loop precisa apenas da capacidade de executar um comando shell e ler um arquivo. (Ele é projetado para e executado no Claude Code; trate outros orquestradores como projetados para, mas ainda não comprovados.)

Quando NÃO usar isto

• A tarefa é pequena o suficiente para ser feita inline — o overhead da delegação não vale a pena.
• ZCode não está instalado, ou seu CLI não tem um provedor de modelo configurado.
• Você quer escrever o código você mesmo, ou só precisa de uma revisão.

Pré-requisitos (verificar uma vez)

1. ZCode está instalado. O CLI vem dentro do aplicativo desktop — ele não está no PATH nem no npm. O relay o resolve nesta ordem: --zcode-path <file> ou ZCODE_CLI primeiro, depois PATH, depois o pacote do aplicativo instalado. No Linux, o aplicativo é um AppImage sem um caminho de instalação fixo, então a flag ou a variável de ambiente é necessária lá — o relay não adivinha nada.
2. Um provedor de modelo está configurado para o CLI, com uma chave que ele pode realmente alcançar. Estar logado no aplicativo desktop não é suficiente — veja abaixo.
3. Você está (ou apontará --cd para) o repositório git de destino.

O relay registra a versão do CLI e como ele foi resolvido em result.json, para que uma instalação surpreendente seja visível após o fato.

Autenticando o CLI headless

Fazer login no aplicativo desktop ZCode não autentica o CLI que este relay controla. O CLI mantém sua própria configuração em ~/.zcode/cli/config.json, separada da do aplicativo desktop, e nada conecta os dois. zcode login é o caminho pretendido, mas onde falha com OAuth response is not valid JSON, o caminho é uma chave de API Z.AI.

Duas peças são necessárias, e elas são separadas:

1. O bloco do provedor deve existir em ~/.zcode/cli/config.json. Ele define o provedor, seu endpoint e seus modelos — o ambiente não pode fornecer isso:

   {
     "provider": {
       "zai": {
         "kind": "anthropic",
         "options": { "apiKeyRequired": true, "baseURL": "https://api.z.ai/api/anthropic" },
         "models": { "glm-5.1": { "name": "GLM-5.1" } }
       }
     },
     "model": { "main": "zai/glm-5.1" }
   }
   

2. A chave pode residir em provider.zai.options.apiKey nesse arquivo, ou no ambiente como qualquer uma de ZAI_API_KEY, ZCODE_API_KEY ou ANTHROPIC_API_KEY. Prefira o ambiente — ele mantém o segredo fora do disco.

Se uma execução falhar com Model provider is missing an API key: <provider>, o bloco do provedor foi resolvido, mas nenhuma chave foi encontrada: defina uma dessas variáveis e reexecute.

Autonomia — leia isto antes de despachar

O próprio termo do ZCode é mode. Ele tem quatro valores; apenas dois são utilizáveis headlessly.

Dois limites declarados claramente, porque ZCode não pode aplicá-los:

• O modo plan recusou edições em testes, mas o relay não trata isso como uma garantia. Ele pega uma impressão digital do Git antes da execução e relata um tri-estado readOnlyViolation depois. Confirme que touchedFiles voltou vazio em vez de assumir que não houve edições.
• ZCode não tem --allowed-tools. Apenas a lista negra de --disallowed-tools existe, e ela é genuinamente aplicada. Uma superfície de ferramenta explicitamente permitida é, portanto, impossível aqui — não assuma uma.

O loop

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

1. Escreva o briefing

ZCode vê apenas o que você envia — sem memória do repositório, sem histórico de chat. Tudo o que a tarefa precisa vai

…