コーディングエージェントのセットアップ

agentee は、コーディングエージェントによって操作されることを前提に設計されています。Claude Code、Codex、Cursor、pi など、シェルコマンドを実行してファイルを編集できるものなら何でも使えます。設定には 2 つの要素があります。スキルはエージェントに作業方法を伝えます。MCP サーバーは任意で、MCP を話すクライアントに同じ操作をツールとして提供します。

#スキルのインストール

スキルは、タスクがその説明に一致するとエージェントが読み込む SKILL.md ファイルです。agentee のスキルは、編集・チェック・レンダリングのループ、設計を構築する順序、ファイル形式の落とし穴、組立とテストのための配置方法、GPU の時間を無駄にせずにシミュレーションを反復する方法をカバーします。

最も簡単な方法は、スキルインストーラーを使うことです。マシン上のエージェントを見つけ、それぞれが参照する場所にファイルを配置します。

npx skills add https://agentee.sh

agentee.sh が /.well-known/agent-skills/index.json に公開するスキルレジストリを読み込みます。レジストリには、ファイルの SHA-256 ダイジェスト付きでスキルがリストされています。npx skills add v0l/agentee は、代わりに GitHub リポジトリから同じスキルをインストールします。

手動でインストールするには、ファイルをエージェントのスキルフォルダに配置します。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

すべてのリリースアーカイブには、skills/agentee 配下にスキルも含まれており、隣接するバイナリと一致します。クローンからビルドする場合は、そのディレクトリをスキルフォルダにリンクしてください。そうすれば、スキルはコードと同期して更新されます。

#MCPサーバーの追加

MCPなしでは、エージェントはシェル経由でCLIを使用します。どこでも動作します。MCPがあれば型付きツールが得られ、render_itemがPNGを会話に直接返します。視覚機能を持つモデルは、ファイルの往復なしに基板を見られます。

agentee mcpは1つのプロジェクトディレクトリをstdioで提供します。TOMLを含むディレクトリを指定します。

Claude Code、プロジェクトディレクトリから:

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

Codex、~/.codex/config.tomlに:

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

Cursor、Claude Desktop、その他の多くのクライアントは共通のJSON形式を受け付けます。.cursor/mcp.json、claude_desktop_config.json、またはクライアント独自の設定に記述します。

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

サーバーはエージェントのためにTOMLを書きません。読み取り、チェック、レンダリング、ルーティング、シミュレーション、そして基板メーカー向けパッケージの書き出しを行います。エージェントは引き続き、独自のツール、またはシェルでのagentee editでファイルを編集します。MCPページにすべてのツールがリストされています。

#フォーマットのリファレンスを渡す

スキルは作業手順です。キーごとの完全なリファレンスは別物として用意されており、必要になったときのみコンテキストを消費します。agentee docs で表示され、MCP ツール format_reference でも返されます。スキルは、エージェントに書きかけのファイル種別に対応するセクションを読むよう指示します。同じテキストは、このサイトの リファレンス 配下と、/llms-full.txt の単一ファイルとしても公開されています。

#作業できる要約を書く

エージェントは、ジュニアエンジニアと同じように基板を設計します。要件が書かれている場合はうまくいき、推測を強いられる場合はうまくいきません。役立つ要約には以下を含めます。

• 基板の機能と、接続されるもの。コネクタ、電圧、電流、信号とその速度。
• 基板メーカーと層数、または予算の上限。jlcpcbの2層または4層の層構成が、最初の基板の多くに適しています。
• サイズ制限、マウンティングホール、コネクタの設置位置。
• メーカー品番で指定した部品。エージェントが自分で選ぶ部品は、理由とともにDESIGN.mdに記録します。
• シミュレーションが必要な項目。RF経路、USBレーン、レールの電圧降下、発熱するレギュレータなど。

例:

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.

ファイルの隣に DESIGN.md を作成するよう依頼してください。スキルは、回路、各部品を選んだ理由、回路に必要なレイアウトルール、未検証の項目を含むドキュメントを維持するようエージェントに指示します。これはあなたがレビューするドキュメントであり、次のセッションで最初に読むものでもあります。

#作業を観察する

エージェントが作業している間に、プロジェクトでagentee viewを実行します。ファイルが変更されるたびにウィンドウが再読み込みされるため、各コンポーネントの配置や配線のルーティングを確認でき、意図しない方向に進んだらエージェントを停止できます。レイアウトでは、コンポーネントを移動したり配線をルーティングしたりできます。保存すると、エージェントが次に読み込むのと同じファイルに変更が書き込まれます。ビューアを参照してください。

#期待されること

エージェントはチェックに大きく依存しますが、それがポイントです。すべての診断メッセージはファイル、項目、場所を特定し、多くの場合は合格する値も示します。それでもあなたに必要とされること:

• 部品の選定。エージェントは妥当な部品を選びますが、購入可能で信頼できる部品はあなたが知っています。agentee partsは在庫と価格の確認に役立ちます。
• 配置の意図。自動配置は出発点です。製品上のコネクタの位置や、ヒートシンクの向きはあなたの判断です。ビューアでそれらのコンポーネントを移動してロックします。
• シミュレーションの予算。FDTD の実行には数十分かかることがあります。スキルは、まずドライランを行い、粗い設定で反復するようエージェントに指示します。GPU の時間が重要な場合は、ブリーフにその旨を明記してください。
• ファイルでは見えないもの。STEPエクスポートを超える機械的な適合性、規制テスト、ファームウェア。