Aider Delegate

Quando Usar

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

Você é o orquestrador. Entregue uma tarefa de codificação delimitada a um implementador separado - Aider - depois revise o que ele produziu e aplique as mudanças você mesmo. Você escreve o resumo e é responsável pelo julgamento; Aider faz a digitação em sua própria execução; 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.

A Única Coisa Que Você Precisa Saber Sobre Aider

Aider confirma por padrão. Duas de suas configurações padrão destruiriam o diff revisável que esta habilidade existe para produzir:

• --auto-commits (padrão True) - Aider confirma suas próprias edições após cada troca.
• --dirty-commits (padrão True) - Aider confirma o trabalho seu pré-existente não confirmado antes de começar a editar.

O relay sempre passa --no-auto-commits e --no-dirty-commits, e nenhum deles é configurável através dele. Se você alguma vez executar aider manualmente em vez de através do relay, passe ambos você mesmo, ou o trabalho será aplicado como commits que você nunca revisou. O relay também passa --no-gitignore, porque Aider de outra forma escreve .aider* em .gitignore na inicialização e suja a árvore que você está prestes a ler.

Quando NÃO Usar Isto

• A tarefa é pequena o suficiente para ser feita inline; a sobrecarga da delegação não vale a pena.
• A CLI aider não está instalada, ou nenhum modelo está configurado para ela.
• Você quer que o implementador gerencie seus próprios commits. Aider pode, mas esta habilidade deliberadamente desliga isso - o diff é o entregável.

Pré-requisitos (verificar uma vez)

1. Instale o Aider - python -m pip install aider-chat, ou o instalador autônomo da documentação de instalação do Aider.
2. Configure um modelo. Aider lê as chaves do provedor do ambiente (OPENAI_API_KEY, ANTHROPIC_API_KEY, …) ou sua própria configuração; veja a documentação de modelos do Aider.
3. Confirme que aider --version é bem-sucedido.
4. Trabalhe em, ou aponte --cd para, o repositório git alvo.

Escolha o Modelo

Aider usa seu próprio modelo configurado quando --model é omitido. Passe --model <name> para escolher outro.

Modelos Locais e Auto-hospedados

Aider se comunica com qualquer endpoint compatível com OpenAI, então esta é também a habilidade para delegar a um modelo executando no próprio hardware do usuário - servidor do llama.cpp, Ollama, vLLM, LM Studio, ou qualquer outra coisa que sirva a mesma API. Combine --model com --api-base:

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo \
  --model openai/<served-model-name> --api-base http://127.0.0.1:<port>/v1

Três coisas diferem de um provedor hospedado:

• O prefixo openai/ é obrigatório. Ele diz ao Aider para falar o protocolo OpenAI para o seu endpoint; a parte depois dele é qualquer nome que seu servidor reporte, não um nome de catálogo de provedor.
• Uma chave de placeholder ainda é necessária. Exporte qualquer OPENAI_API_KEY não vazio. A biblioteca cliente exige o cabeçalho mesmo quando o servidor ignora seu valor.
• Peça um formato de edição menor. Modelos locais frequentemente falham no formato padrão diff do Aider, que requer blocos exatos de busca/substituição. --edit-format whole troca tokens por confiabilidade; mantenha o escopo do resumo apertado com --file para que reescritas de arquivo inteiro permaneçam baratas.

Um endpoint local que não está em execução parece um travamento, não um erro: Aider tenta reconectar até que o watchdog --timeout do relay dispare e reporte status: "timeout". Confirme que o servidor está ativo antes de despachar um resumo longo.

Permanecendo Offline

Nenhuma conta ou registro de provedor está envolvido: Aider é uma instalação pip, o endpoint é seu, e OPENAI_API_KEY só precisa ser não vazio. O relay fixa as flags que de outra forma chegariam à rede sozinhas - --no-check-update, --no-analytics (o padrão do próprio Aider é random, que inclui algumas sessões por si só), e --no-detect-urls, sem o qual Aider oferece para raspar qualquer URL no resumo e --yes-always aceita essa oferta silenciosamente.

--no-suggest-shell-commands fecha o caminho restante pelo qual uma execução poderia alcançar a rede sem ser solicitada. O que fica fora do controle do relay é o próprio resumo: instruções que dizem ao Aider para instalar um pacote ou chamar uma API ainda serão executadas, e --auto-lint executa as ferramentas próprias do repositório. Offline aqui significa que nada no caminho de despacho alcança a rede por conta própria - não