配置你的编码智能体

agentee 旨在由编码智能体驱动：Claude Code、Codex、Cursor、pi 或任何其他能运行 shell 命令并编辑文件的工具。需要设置两个部分。技能告诉智能体如何工作。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 时，智能体通过 shell 使用 CLI，这在任何地方都能工作。有了 MCP，它获得类型化的工具，且 render_item 直接将 PNG 返回到对话中，因此具有视觉能力的模型无需文件往返即可查看电路板。

agentee mcp 通过 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。它负责读取、检查、渲染、布线、仿真和生成板厂制造文件包；智能体仍然用自己的工具或在 shell 中用 agentee edit 编辑文件。MCP 页面 列出了所有工具。

#提供格式参考

技能是关于如何工作的。完整的逐键参考是独立的，因此只在需要时消耗上下文：agentee docs 打印它，MCP 工具 format_reference 返回它。技能告诉智能体阅读它即将编写的文件类型对应的章节。相同的文本也在这个网站的 参考 下，以及作为单个文件在 /llms-full.txt。

#编写一份可供其工作的简报

智能体设计电路板的方式就像初级工程师一样：当需求被写下来时，设计得不错；当它必须猜测需求时，设计得很差。一份有用的简报应包含：

• 电路板的功能，以及与之连接的内容：连接器、电压、电流、信号及其速率。
• 板厂和层数，或者你希望控制在之下的成本。jlcpcb 配合双层或四层叠层适合大多数首块电路板。
• 尺寸限制、安装孔以及连接器必须放置的位置。
• 你已经选定的元件，按制造商料号。智能体自行选择的元件应放入 DESIGN.md 并附上理由。
• 必须仿真的内容：射频路径、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。窗口会在文件更改时重新加载，因此你可以看到每个元件放置和走线落位，并在智能体走向你不希望的方向时停止它。在 PCB 布局中，你可以自己移动元件和布线；保存会将更改写入智能体下次读取的同一文件。参见 查看器。

#预期结果

智能体会大量依赖检查，这正是重点：每个诊断信息都会指明文件、项目和位置，大多数还会指明一个通过的值。仍然需要你处理的事项：

• 元件选择。智能体会选择合理的元件；你知道哪些元件可以购买且值得信赖。agentee parts 有助于查询库存和价格。
• 放置意图。自动放置只是一个开始。连接器在产品上的位置，或散热器朝向哪一面，由你决定。在查看器中移动这些元件并锁定它们。
• 仿真预算。一次 FDTD 运行可能需要几十分钟。技能告诉智能体先进行试运行并粗略迭代，但如果 GPU 时间很重要，请在简报中说明。
• 文件无法看到的内容：超出 STEP 导出的机械适配、法规测试、固件。