Configurar o seu agente de código

O agentee foi construído para ser conduzido por um agente de programação: Claude Code, Codex, Cursor, pi ou qualquer outro que possa executar comandos de shell e editar ficheiros. Há duas peças a configurar. A skill diz ao agente como trabalhar. O servidor MCP é opcional e dá aos clientes que falam MCP as mesmas operações como ferramentas.

#Instalar a skill

Uma skill é um ficheiro SKILL.md que o agente carrega quando uma tarefa corresponde à sua descrição. A skill do agentee cobre o ciclo de edição, verificação e renderização, a ordem para construir um projeto, as armadilhas no formato de ficheiro, como posicionar para montagem e teste e como iterar em simulações sem gastar horas de tempo de GPU.

A forma mais rápida é o instalador de skills, que encontra os agentes na sua máquina e coloca o ficheiro onde cada um procura:

npx skills add https://agentee.sh

Lê o registo de skills que o agentee.sh publica em /.well-known/agent-skills/index.json, que lista a skill com um resumo SHA-256 do seu ficheiro. npx skills add v0l/agentee instala a mesma skill a partir do repositório GitHub em vez disso.

Para instalar manualmente, coloque o ficheiro na pasta de skills do seu agente. Para o Claude Code:

mkdir -p ~/.claude/skills/agentee
curl -fsSL https://agentee.sh/.well-known/agent-skills/agentee/SKILL.md -o ~/.claude/skills/agentee/SKILL.md

Cada arquivo de libertação também inclui a skill em skills/agentee, correspondendo ao binário ao lado. Se compilar a partir de um clone, ligue esse diretório à sua pasta de skills para que a skill se atualize com o código.

#Adicione o servidor MCP

Sem MCP, o agente usa a CLI através do seu shell, o que funciona em todo o lado. Com MCP, obtém ferramentas tipadas, e o render_item devolve o PNG diretamente para a conversa, pelo que um modelo com visão vê a placa sem uma ida e vinda de ficheiros.

O agentee mcp serve um diretório de projeto sobre stdio. Aponte-o para o diretório que contém o TOML.

Claude Code, a partir do diretório do projeto:

claude mcp add agentee -- agentee mcp "$PWD"

Codex, em ~/.codex/config.toml:

[mcp_servers.agentee]
command = "agentee"
args = ["mcp", "/path/to/project"]

Cursor, Claude Desktop e a maioria dos outros clientes aceitam a forma JSON comum, em .cursor/mcp.json, claude_desktop_config.json ou nas definições próprias do cliente:

{
  "mcpServers": {
    "agentee": {
      "command": "agentee",
      "args": ["mcp", "/path/to/project"]
    }
  }
}

O servidor não escreve TOML para o agente. Lê, verifica, renderiza, encaminha, simula e escreve o pacote de fabrico; o agente continua a editar ficheiros com as suas próprias ferramentas ou com agentee edit num terminal. A página MCP lista todas as ferramentas.

#Forneça a referência de formato

A skill é como trabalhar. A referência completa chave a chave é separada, para que só custe contexto quando necessário: agentee docs imprime-a, e a ferramenta MCP format_reference devolve-a. A skill diz ao agente para ler a secção para o tipo de ficheiro que está prestes a escrever. O mesmo texto está neste site em Referência, e como um ficheiro em /llms-full.txt.

#Escreva um enunciado com que ele possa trabalhar

Um agente desenha uma placa como um engenheiro júnior: bem, quando os requisitos estão escritos; mal, quando tem de os adivinhar. Um enunciado útil diz:

• O que a placa faz e o que se liga a ela: conetores, tensões, correntes, sinais e as suas velocidades.
• O fabricante e o número de camadas, ou o custo que quer manter abaixo. jlcpcb com um stackup de duas ou quatro camadas serve a maioria das primeiras placas.
• Limites de dimensão, furos de montagem e onde os conetores devem ficar.
• Componentes que já escolheu, pelo número de peça do fabricante. Os componentes que o agente escolhe por si devem ir para DESIGN.md com a razão.
• O que deve ser simulado: o caminho RF, uma linha USB, a queda de uma fonte, um regulador quente.

Por exemplo:

Design a 4 layer JLCPCB board, at most 40 x 30 mm, that powers a Raspberry Pi
Pico from USB-C or a 2S LiPo through an ideal diode OR, with a 3.3 V 1 A buck
for an external sensor header. Put the USB-C and the battery JST-PH on the
same short edge. Use parts JLCPCB stocks. Write DESIGN.md as you go, run a DC
drop sim of the 3.3 V rail at 1 A and a thermal sim with the buck at 0.6 W.

Peça um DESIGN.md junto aos ficheiros. A skill diz ao agente para manter um, com o circuito, a razão de cada escolha de componente, as regras de layout que o circuito exige e o que ainda não foi verificado. É o documento que revê e o que a próxima sessão lê primeiro.

#Veja-o a trabalhar

Execute agentee view no projeto enquanto o agente trabalha. A janela recarrega sempre que um ficheiro muda, por isso vê cada componente e pista a serem colocados, e pode parar o agente quando ele vai para onde não quer. Num layout, pode mover componentes e encaminhar pistas por si; guardar escreve-os no mesmo ficheiro que o agente lê a seguir. Veja O visualizador.

#O que esperar

O agente vai apoiar-se muito na verificação, e esse é o objetivo: cada diagnóstico nomeia o ficheiro, o item e o local, e a maioria nomeia um valor que passa. O que ainda precisa de si:

• Escolha de componentes. O agente escolhe componentes plausíveis; si sabe quais pode comprar e em que pode confiar. agentee parts ajuda com stock e preço.
• Intenção de colocação. A colocação automática é um início. Onde um conetor fica num produto, ou para que lado uma dissipador de calor aponta, é decisão sua. Mova esses componentes no visualizador e bloqueie-os.
• Orçamentos de simulação. Uma execução FDTD pode demorar dezenas de minutos. A skill diz ao agente para fazer primeiro uma execução de teste e iterar de forma grosseira, mas indique isso no enunciado se o tempo de GPU for importante.
• Tudo o que os ficheiros não veem: encaixe mecânico além da exportação STEP, testes regulamentares, firmware.