Как собрать плагин VST3 или CLAP с помощью ИИ-агента для кодинга

Почему агенты ошибаются в аудиоплагинах

Незнакомая C++-библиотека редко заставляет агента отказаться от работы. Она заставляет его импровизировать, а аудиоплагины наказывают за импровизацию тремя способами:

1. Придуманные имена. Класс, которого должно быть, например CompressorPro, или настоящий класс, которому приписан метод из другого фреймворка. Код читается идеально и не компилируется.
2. Код, который компилируется и всё равно неверен. Аллокация или блокировка внутри process(), который работает в аудиопотоке. Это работает на машине разработчика и отваливается под нагрузкой в чьей-то сессии.
3. Правила, которые нигде не записаны в API. Лимитер с look-ahead, который не сообщает свою задержку, размазывает каждый параллельный микс, в котором стоит. Таблица параметров, переставленная в версии 1.1, загружает старые сессии в неправильные контролы. Ни один заголовок об этом не говорит.

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

Что нужно агенту вместо этого

Три вещи, каждая из которых отвечает на один из этих режимов сбоя:

Все три генерируются из заголовков SDK одним и тем же скриптом. Это важнее, чем кажется. Рукописная шпаргалка для агентов расходится с кодом в пределах одного релиза, и тогда она становится вторым источником придуманных имён. Здесь npm run verify:llms ломает сборку, если файлы расходятся с заголовками, а npm run verify:mcp проверяет, что поиск находит каждый публичный тип, так что «нет совпадений» от сервера — настоящий ответ, а не дыра в индексе.

Шесть инструментов MCP-сервера

Сервер запускается из локального клона по stdio, требует только Node.js, и каждый инструмент лишь читает файлы в клоне.

Пример разницы. По запросу CompressorPro сервер отвечает, что в SDK ничего не совпадает. По запросу «ladder filter» он возвращает LadderFilter и диодный лестничный фильтр с заголовками, в которых они находятся. Агент пишет второе, а не первое.

Установка

Клонируйте SDK, затем добавьте скилл и сервер в своего агента. Для Claude Code:

git clone https://github.com/SonorieAI/sonore-sdk "$HOME/sonore-sdk"
npx skills add SonorieAI/sonore-sdk --skill sonore-sdk -a claude-code -g
claude mcp add --scope user sonore-sdk -- node "$HOME/sonore-sdk/scripts/mcp-server.mjs"

Для Codex используйте -a codex и codex mcp add. Cursor и Antigravity получают скилл через -a cursor или -a antigravity, а сервер — через файл конфигурации MCP. Кнопка «Установить скилл и MCP» на главной странице содержит точные команды для каждого агента. Если инструмент командной строки skills недоступен, то же самое делает копирование skills/sonore-sdk в папку скиллов агента.

Первый промпт, который работает

Будьте конкретны в описании плагина и скажите, что означает «готово»:

Make a tape-style saturator plugin with Drive, Tone and Mix.
Start from a generated Sonore project. Look up every sonore:: name
before you use it. It is done when it builds, ctest passes, and
clap-validator and pluginval run clean.

Когда скилл загружен, агент сам следует рабочему процессу SDK: генерирует проект с помощью sonore_new_plugin.cmake, пишет DSP в единственный файл src/plugin.cpp, проверяет имена по ходу дела и собирает. Один исходный файл становится .clap, .vst3, Audio Unit на macOS, бандлом LV2 и автономным приложением, а тот же проект собирает AUv3 для iPhone и iPad и приложение для Android.

Что значит «готово»

Плагин, который компилируется, — это черновик. Сгенерированный проект даёт агенту три проверки, которые нужно пройти по порядку того, что они доказывают:

1. Он собирается во все форматы из одной сборки.
2. ctest проходит. Он запускает два теста. Флаг --verify автономного приложения рендерит звук офлайн и проверяет, что всё в порядке. В проекте, собранном из клона SDK, аудит реального времени (sonore_add_rt_test) подсчитывает каждую аллокацию в аудиопотоке на всех частотах дискретизации и размерах блока и падает при любой. SDK подчиняет свои собственные примеры той же планке: девять частот дискретизации от 8 кГц до 384 кГц, размеры блока от 1 до 8192, ноль аллокаций.
3. Валидаторы проходят. clap-validator и pluginval загружают плагин так, как это делают хосты. Оба шаблона проекта проходят их на уровне строгости 10 pluginval в сгенерированном виде, поэтому провал означает, что проблему внёс агент.

Аудит и валидаторы ловят то, чего не видно при чтении кода, поэтому их стоит включать в промпт.

Что по-прежнему нужно вам

Агент с правильными инструментами пишет плагин, который загружается, проходит валидацию и не выделяет память в аудиопотоке. Он не может сказать, хорошо ли звучит сатуратор, правильно ли ощущается интерфейс в сессии или ведёт ли себя нужный вам хост. Прослушивание, вкус и тестирование в вашей DAW остаются за вами. То же касается форматов с привратниками: AAX требует соглашения разработчика с Avid и подписи PACE, которые никакой фреймворк выдать не может.

Пошаговую версию без агента читайте в Начало работы. О том, как SDK сравнивается с JUCE, iPlug2 и остальными, см. Фреймворки для аудиоплагинов: сравнение.

Источники

• Репозиторий Sonore SDK: раздел README «Writing plugins with a coding agent», llms.txt и scripts/mcp-server.mjs
• Скилл sonore-sdk
• Спецификация Model Context Protocol
• Формат Agent Skills
• Соглашение llms.txt