Delegar Código de Comando

Quando Usar

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

Você é o orquestrador. Essa habilidade permite que você entregue uma tarefa de codificação delimitada a um implementador separado — o Command Code CLI (cmd) —, depois revise o que ele produziu e o integre você mesmo. Você escreve o resumo e assume o julgamento; o Command Code faz a digitação em sua árvore de trabalho; 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, portanto, funciona da mesma forma, quer você seja Claude Code, OpenCode com um modelo selecionado ou qualquer agente comparável. (Ele é projetado e executado no Claude Code; trate outros orquestradores como projetados para isso, ainda não comprovados.)

Quando NÃO Usar Isso

• A tarefa é pequena o suficiente para ser feita inline — a sobrecarga da delegação não vale a pena.
• O CLI cmd não está instalado ou não está autenticado (execute cmd login).
• Você quer escrever o código você mesmo, ou só precisa de uma revisão (o Command Code tem seu próprio /review).
• Você está no Windows nativo e cmdc --version não funciona. O upstream recomenda WSL para uso estável no Windows.

Leia Isso Antes do Primeiro Envio: O Modelo de Autonomia

O modo headless do Command Code tem exatamente dois estados, sem nada entre eles:

• Padrão (-p sem --yolo): read, grep e glob funcionam. Toda escrita, edição e chamada de shell são recusadas pela camada de permissão do CLI, e o modo headless não tem prompt para concedê-las durante a execução. Este é o --read-only do relay.
• --yolo (alias --dangerously-skip-permissions): todas as ferramentas são permitidas, em qualquer lugar que o processo possa alcançar. Não há sandbox de sistema de arquivos e nenhuma restrição de caminho. É isso que uma execução de implementação precisa, então o relay o passa por padrão.

--permission-mode auto-accept e --tools-all não removem o portão de escrita headless. Consultas diretas ao CLI recusaram escrita, edição e shell com ambos. Portanto, uma execução de implementação através do Command Code é uma execução de confiança total: escopo com um resumo conciso e uma árvore de trabalho limpa, não com um sandbox. O resumo é orientação, e um worktree git isola um checkout sem conter o processo. Se escritas fora da árvore de destino forem inaceitáveis, use um sandbox imposto pelo sistema operacional, como codex-delegate, ou execute este dentro de um contêiner.

Antes da primeira execução capaz de escrever, explique este modo de confiança total não sandbox e obtenha aceitação humana explícita. Uma solicitação para delegar ao Command Code não é por si só consentimento para acesso a todo o host.

Pré-requisitos (verificar uma vez)

1. cmd --version é bem-sucedido e cmd status relata autenticado. Caso contrário, instale o Command Code e execute cmd login.
2. Confirme o CLI no PATH. No macOS/Linux, command -v cmd mostra o cmd ativo. No Windows nativo, use cmdc --version; cmd é o shell do sistema. O relay usa cmdc lá e inicia seu shim npm .cmd através de cmd.exe. COMMANDCODE_BIN permanece um override de caminho absoluto e nunca deve apontar para o interpretador de comando do sistema. O relay registra a versão que executou em result.json, então um binário incorreto é visível após o fato.
3. Você está (ou apontará --cd para) o repositório git de destino, e sua árvore está limpa antes de você despachar — uma execução de confiança total é muito mais fácil de revisar contra uma linha de base limpa.

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 Resumo

O Command Code vê apenas o texto que você envia — sem memória do repositório, sem histórico de chat, sem contexto compartilhado (além do AGENTS.md do próprio repositório, que ele lê automaticamente). Tudo o que a tarefa precisa vai no resumo: o objetivo, o estado atual, o que mudar, o que deixar intocado, os comandos de gate atuais do projeto (descubra-os no AGENTS.md/CLAUDE.md/Makefile do repositório — não presuma), e um contrato de relatório. Diga a ele que ele não fará commit (você fará). Mantenha uma tarefa por resumo. Orientação completa e um modelo: references/writing-the-brief.md.

2. Despachar

Envie o resumo para o Command Code com o helper empacotado. Ele envolve cmd -p, captura a execução e escreve um result.json estruturado — então seu único trabalho é "executar um comando, ler um arquivo." (<skill-dir> abaixo é o diretório instalado desta habilidade — a pasta contendo este SKILL.md, ou seja, o diretório

…