Configura il tuo agente di coding

agentee è costruito per essere guidato da un agente di coding: Claude Code, Codex, Cursor, pi o qualsiasi altro che possa eseguire comandi shell e modificare file. Ci sono due parti da configurare. La skill dice all'agente come lavorare. Il server MCP è opzionale e fornisce ai client che parlano MCP le stesse operazioni come tool.

#Installa la skill

Una skill è un file SKILL.md che l'agente carica quando un compito corrisponde alla sua descrizione. La skill di agentee copre il ciclo di modifica, check e render, l'ordine per costruire un design, le insidie del formato file, come posizionare per assemblaggio e test, e come iterare sulle simulazioni senza spendere ore di tempo GPU.

Il modo più rapido è l'installer di skill, che trova gli agenti sulla tua macchina e mette il file dove ciascuno lo cerca:

npx skills add https://agentee.sh

Legge il registro di skill pubblicato da agentee.sh in /.well-known/agent-skills/index.json, che elenca la skill con un digest SHA-256 del suo file. npx skills add v0l/agentee installa la stessa skill dal repository GitHub invece.

Per installare a mano, metti il file nella cartella skill del tuo agente. Per 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

Ogni archivio di rilascio contiene anche la skill sotto skills/agentee, corrispondente al binario accanto. Se compili da un clone, collega quella directory alla tua cartella skill in modo che la skill si aggiorni con il codice.

#Aggiungi il server MCP

Senza MCP l'agente usa la CLI attraverso la sua shell, che funziona ovunque. Con MCP ottiene tool tipizzati, e render_item restituisce il PNG direttamente nella conversazione, quindi un modello con visione guarda la scheda senza un round trip di file.

agentee mcp serve una directory di progetto su stdio. Punta alla directory che contiene il TOML.

Claude Code, dalla directory di progetto:

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

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

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

Cursor, Claude Desktop e la maggior parte degli altri client accettano la forma JSON comune, in .cursor/mcp.json, claude_desktop_config.json o nelle impostazioni del client:

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

Il server non scrive TOML per l'agente. Legge, verifica, renderizza, instrada, simula e scrive il pacchetto di produzione; l'agente continua a modificare i file con i propri strumenti o con agentee edit in un terminale. La pagina MCP elenca tutti gli strumenti.

#Dagli il riferimento di formato

La skill è il modo di lavorare. Il riferimento completo chiave per chiave è separato, in modo da costare contesto solo quando serve: agentee docs lo stampa, e il tool MCP format_reference lo restituisce. La skill dice all'agente di leggere la sezione per il tipo di file che sta per scrivere. Lo stesso testo è su questo sito sotto Riferimento, e come un solo file in /llms-full.txt.

#Scrivi un brief su cui può lavorare

Un agente progetta una scheda come farebbe un ingegnere junior: bene quando i requisiti sono scritti, male quando deve indovinarli. Un brief utile dice:

• Cosa fa la scheda e cosa si collega a essa: connettori, tensioni, correnti, segnali e le loro velocità.
• Il produttore e il numero di layer, o il costo che vuoi non superare. jlcpcb con uno stackup a due o quattro layer va bene per la maggior parte delle prime schede.
• Limiti di ingombro, fori di montaggio e dove devono stare i connettori.
• Componenti che hai già scelto, per codice produttore. I componenti scelti dall'agente vanno in DESIGN.md con la motivazione.
• Cosa va simulato: il percorso RF, una linea USB, la caduta di tensione di un rail, un regolatore in temperatura.

Ad esempio:

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.

Chiedi un DESIGN.md accanto ai file. La skill dice all'agente di mantenerne uno, con il circuito, perché ogni componente è stato scelto, le regole di layout che il circuito richiede e cosa non è ancora verificato. È il documento che rividi tu, e quello che la sessione successiva legge per primo.

#Guardalo lavorare

Esegui agentee view nel progetto mentre l'agente lavora. La finestra si aggiorna a ogni modifica di un file, così vedi ogni piazzamento e pista che viene posata e puoi fermare l'agente quando va dove non vuoi. Su un layout puoi spostare componenti e instradare piste tu stesso; salvando scrivi le modifiche nello stesso file che l'agente legge alla prossima apertura. Vedi Il visualizzatore.

#Cosa aspettarsi

L'agente farà molto affidamento sulla verifica, ed è questo il punto: ogni diagnostica indica il file, l'elemento e la posizione, e la maggior parte indica un valore che passa. Le cose che richiedono ancora te:

• Scelta dei componenti. L'agente sceglie componenti plausibili; tu sai quali puoi comprare e di cui ti fidi. agentee parts aiuta con disponibilità e prezzo.
• Intenzione di piazzamento. Il piazzamento automatico è un inizio. Dove va un connettore su un prodotto, o da che lato guarda un dissipatore, è una tua decisione. Sposta quei componenti nel visualizzatore e bloccali.
• Budget di simulazione. Una simulazione FDTD può richiedere decine di minuti. La skill dice all'agente di fare prima un dry-run e di iterare in modo grossolano, ma specificalo nel brief se il tempo GPU conta.
• Tutto ciò che i file non possono vedere: adattamento meccanico oltre l'export STEP, test normativi, firmware.