Konfiguracja agenta kodującego

agentee jest zbudowany, aby być sterowany przez agenta kodującego: Claude Code, Codex, Cursor, pi lub cokolwiek innego, co może uruchamiać polecenia shell i edytować pliki. Są dwie części do skonfigurowania. Skill mówi agentowi, jak pracować. Serwer MCP jest opcjonalny i daje klientom mówiącym MCP te same operacje jako narzędzia.

#Zainstaluj skill

Skill to plik SKILL.md, który agent wczytuje, gdy zadanie pasuje do jego opisu. Skill agentee obejmuje pętlę edycji, sprawdzania i renderowania, kolejność budowania projektu, pułapki w formacie plików, sposób rozmieszczania elementów pod montaż i testy oraz sposób iterowania symulacji bez spędzania godzin na GPU.

Najszybszy sposób to instalator skills, który znajduje agentów na Twoim komputerze i umieszcza plik tam, gdzie każdy z nich go szuka:

npx skills add https://agentee.sh

Czyta rejestr skilli publikowany przez agentee.sh pod adresem /.well-known/agent-skills/index.json, który zawiera listę skilli z sumą kontrolną SHA-256 pliku. npx skills add v0l/agentee instaluje ten sam skill z repozytorium GitHub.

Aby zainstalować ręcznie, umieść plik w folderze skills swojego agenta. Dla 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

Każdy archiwum wydania zawiera również skill pod skills/agentee, zgodny z binarkiem obok. Jeśli budujesz z klonu, utwórz dowiązanie tego katalogu do swojego folderu skills, aby skill aktualizował się razem z kodem.

#Dodaj serwer MCP

Bez MCP agent używa CLI przez swoją powłokę, co działa wszędzie. Z MCP dostaje typowane narzędzia, a render_item zwraca PNG bezpośrednio do rozmowy, więc model z wizją patrzy na płytkę bez rundy pliku.

agentee mcp serwuje jeden katalog projektu przez stdio. Wskaż go na katalog zawierający TOML.

Claude Code, z katalogu projektu:

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

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

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

Cursor, Claude Desktop i większość innych klientów przyjmuje wspólną formę JSON, w .cursor/mcp.json, claude_desktop_config.json lub własnych ustawieniach klienta:

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

Serwer nie zapisuje TOML za agenta. Czyta, sprawdza, renderuje, trasy, symuluje i zapisuje pakiet produkcyjny; agent nadal edytuje pliki własnymi narzędziami lub przez agentee edit w powłoce. Strona MCP zawiera listę wszystkich narzędzi.

#Podaj mu referencję formatu

Skill to sposób pracy. Pełna referencja klucz po kluczu jest osobna, więc kosztuje kontekst tylko wtedy, gdy jest potrzebna: agentee docs ją wyświetla, a narzędzie MCP format_reference ją zwraca. Skill mówi agentowi, aby przeczytał sekcję dla rodzaju pliku, który zamierza napisać. Ten sam tekst znajduje się na tej stronie pod Referencją oraz jako jeden plik pod /llms-full.txt.

#Napisz zwięzły opis, z którego może korzystać

Agent projektuje płytkę tak, jak początkujący inżynier: dobrze, gdy wymagania są zapisane, źle, gdy musi je zgadywać. Przydatny opis zawiera:

• Co robi płytka i co do niej podłączasz: złącza, napięcia, prądy, sygnały i ich prędkości.
• Producent i liczbę warstw, albo koszt, którego chcesz nie przekroczyć. jlcpcb ze stackupem dwu- lub czterowarstwowym nadaje się do większości pierwszych płytek.
• Ograniczenia rozmiaru, otwory montażowe i gdzie muszą siedzieć złącza.
• Części, które już wybrałeś, podane numerem części producenta. Części, które agent wybierze sam, powinny trafić do DESIGN.md z uzasadnieniem.
• Co trzeba zasymulować: ścieżkę RF, pasmo USB, spadek napięcia na szynie, gorący regulator.

Na przykład:

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.

Poproś o DESIGN.md obok plików. Skill mówi agentowi, aby utrzymywał ten dokument, zawierający obwód, powody wyboru każdego elementu, zasady layoutu wymagane przez obwód oraz to, co nadal nie zostało zweryfikowane. To dokument, który przeglądasz, i ten, który następna sesja czyta jako pierwszą.

#Obserwuj, jak pracuje

Uruchom agentee view w projekcie, podczas gdy agent pracuje. Okno odświeża się przy każdej zmianie pliku, więc widzisz, jak lądują kolejne elementy i ścieżki, i możesz zatrzymać agenta, gdy zmierza w miejsce, którego nie chcesz. W layoutie możesz sam przesuwać elementy i prowadzić ścieżki; zapisanie wpisywa zmiany do tego samego pliku, który agent odczyta następnym razem. Zobacz Podgląd.

#Czego się spodziewać

Agent będzie mocno polegać na sprawdzaniu, i o to chodzi: każda diagnostyka podaje plik, element i miejsce, a większość podaje wartość, która przechodzi. Co nadal wymaga twojej uwagi:

• Wybór części. Agent wybiera prawdopodobne części; ty wiesz, które możesz kupić i którym ufasz. agentee parts pomaga z dostępnością i ceną.
• Zamysł rozmieszczenia. Automatyczne rozmieszczenie to początek. Gdzie złącze ma być na produkcie albo z której strony ma patrzeć radiator, to twoja decyzja. Przesuń te elementy w podglądzie i zablokuj je.
• Budżety symulacji. Uruchomienie FDTD może zająć dziesiątki minut. Skill mówi agentowi, aby najpierw wykonał dry-run i iterował grubo, ale powiedz o tym w zleceniu, jeśli czas na GPU ma znaczenie.
• Wszystko, czego pliki nie widzą: dopasowanie mechaniczne poza eksportem STEP, testy regulacyjne, firmware.