Настройка кодинг-агента

agentee создан для управления кодинг-агентом: Claude Code, Codex, Cursor, pi или любым другим, который может выполнять команды оболочки и редактировать файлы. Нужно настроить две вещи. Skill говорит агенту, как работать. MCP-сервер опционален и даёт клиентам, поддерживающим MCP, те же операции в виде инструментов.

#Установите skill

Skill это файл SKILL.md, который агент загружает, когда задача соответствует его описанию. Skill agentee охватывает цикл «правка, проверка, рендер», порядок сборки проекта, ловушки формата файлов, как размещать компоненты для сборки и тестирования и как итерировать моделирование, не тратя часы GPU-времени.

Самый быстрый способ это установщик skills, который находит агенты на вашей машине и кладёт файл туда, куда каждый из них смотрит:

npx skills add https://agentee.sh

Он читает реестр skill, который agentee.sh публикует по адресу /.well-known/agent-skills/index.json, где skill указан с SHA-256-хешем файла. npx skills add v0l/agentee устанавливает тот же skill из репозитория GitHub.

Чтобы установить вручную, положите файл в папку skills вашего агента. Для 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

Каждый архив релиза также содержит skill в skills/agentee, соответствующий бинарнику рядом. Если вы собираете из клонированного репозитория, создайте символическую ссылку на эту директорию в вашей папке skills, чтобы skill обновлялся вместе с кодом.

#Добавьте MCP-сервер

Без MCP агент использует командную строку через оболочку, что работает везде. С 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 за агента. Он читает, проверяет, рендерит, маршрутизирует, симулирует и собирает пакет для завода. Агент по-прежнему редактирует файлы своими инструментами или командой agentee edit в оболочке. На странице MCP перечислены все инструменты.

#Дайте ему справочник по формату

Skill описывает, как работать. Полный справочник по ключам вынесен отдельно, чтобы занимать контекст только при необходимости: agentee docs выводит его, а MCP-инструмент format_reference возвращает его. Skill указывает агенту прочитать раздел для типа файла, который он собирается написать. Тот же текст доступен на этом сайте в разделе Справочник и одним файлом по адресу /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 рядом с файлами. Skill указывает агенту вести этот файл: в нём описываются схема, причины выбора каждого компонента, правила топологии платы, необходимые для схемы, и что ещё не проверено. Это документ, который вы просматриваете, и тот, который следующая сессия читает первым.

#Следите за работой

Запустите agentee view в проекте, пока агент работает. Окно перезагружается при каждом изменении файла, поэтому вы видите, как размещаются компоненты и прокладываются проводники, и можете остановить агента, если он пошёл не туда. В топологии вы можете перемещать компоненты и прокладывать проводники сами; при сохранении изменения записываются в тот же файл, который агент прочитает следующим. См. Просмотрщик.

#Чего ожидать

Агент будет активно опираться на проверку, и в этом суть: каждая диагностика называет файл, элемент и место, а большинство из них указывают значение, при котором проверка проходит. Что всё ещё требует вашего участия:

• Выбор компонентов. Агент подбирает правдоподобные детали; вы знаете, какие из них можно купить и которым доверяете. Команда agentee parts помогает с наличием и ценой.
• Намерения по размещению. Автоматическое размещение это только начало. Где на изделии находится разъём или какой стороной обращён радиатор, решаете вы. Переместите эти компоненты в просмотрщике и зафиксируйте их.
• Бюджеты симуляции. Запуск FDTD может занимать десятки минут. Skill указывает агенту сначала выполнить пробный запуск и итерировать с грубым шагом, но если время на GPU важно, укажите это в брифе.
• Всё, чего не видно в файлах: механическая совместимость за пределами экспорта STEP, сертификационные испытания, прошивка.