Перейти к основному содержимому

Spring Agent Toolkit: контекст и навыки для агента

Редакция: сами навыки устанавливаются в AI-агента и от редакции IDE не зависят. Слой Spring MCP, который отдаёт агенту структуру приложения, требует Spring-инструментов OpenIDE Pro.

Агент, который знает только файлы проекта, пишет «средний код с GitHub»: свои соглашения по JPA-маппингам, DTO, MapStruct, именованию REST-эндпоинтов, транзакциям и миграциям он не видит и придумывает заново. Spring Agent Toolkit сужает эту рамку: агент сначала разбирается в приложении, потом меняет код, и делает это по правилам конкретного стека.

Набор состоит из трёх слоёв:

СлойЧто даёт
Навыки (Spring Skills)Инструкции и примеры для повторяющихся задач Spring: как исследовать проект, как менять модель данных, как добавить контроллер
Spring MCPСтруктурированные данные из IDE: сущности, репозитории, зависимости бинов, эндпоинты, зависимости модулей, миграции, исходники
Интеграции с агентамиУстановка одних и тех же навыков в разные агенты

Слой Spring MCP — это то, чем OpenIDE полезен агенту помимо редактора: модель приложения агент получает от IDE, а не собирает поиском по файлам. Большинство навыков начинается с проверки, подключён ли MCP: если да — берут структуру приложения оттуда, если нет — либо помогают его настроить, либо читают файлы напрямую, когда это безопасно для конкретной задачи.

Навыки​

Набор открыт: github.com/Amplicode/spring-skills. Его ведут команды Amplicode и Spring AIO.

НавыкЧто делает
spring-exploreИсследует приложение: стек, модули, сущности, репозитории, сервисы, эндпоинты
spring-planningСоставляет план реализации в docs/plans/: сбор контекста, выбор подхода, декомпозиция
spring-data-jpaРабота с JPA-сущностями, репозиториями, проекциями и транзакциями по соглашениям проекта
spring-data-jdbcАгрегаты Spring Data JDBC: AggregateReference, @MappedCollection, встроенные объекты
crud-rest-controllerREST-контроллеры с CRUD-эндпоинтами поверх репозитория, с DTO, маппингом и пагинацией
dto-creatorDTO для сущности: Java-класс, record, Java + Lombok или Kotlin data class
mapper-creatorМаппер между сущностью и DTO: MapStruct или собственный конвертер
spring-security-configurationКонфигурация Spring Security: аутентификация, авторизация, защита HTTP
kafka-configurationНастройка стартера Kafka через application.yml и генерация KafkaConfiguration
connekt-script-writerСкрипты .connekt.kts для проверки эндпоинтов
codefmtПереформатирование кода через IDE по код-стилю проекта, оптимизация импортов
run-testsЗапуск тестов Gradle по типу или модулю с компактным отчётом
coverageПокрытие кода: по проекту целиком или по группе тестов, пакету, подпроекту
mutation-testingМутационное тестирование PIT: настройка, запуск, разбор выживших мутантов
java-debugОтладка через MCP отладчика: точки останова, шаги, вычисление выражений, стек
amplicode-installУстановка плагина Amplicode и настройка Spring Agent

Набор развивается: часть навыков помечена в репозитории как готовая, часть — как требующая доработки. Актуальные статусы смотрите там же.

Установка навыков​

Во все поддерживаемые агенты сразу:

npx skills add Amplicode/spring-skills -g

Только в выбранные:

npx skills add Amplicode/spring-skills -g -a claude-code -a codex -a gemini-cli

Посмотреть список без установки — npx skills add Amplicode/spring-skills --list, обновить установленные — npx skills update.

Без флага -g навыки ставятся в текущий проект, с -g — в домашние каталоги поддерживаемых агентов. Требуется Git и Node.js (npm). Есть и альтернативный установщик — скрипты install.sh и install.ps1 из репозитория.

Навыки устанавливаются в Codex, Claude Code, OpenCode, Gemini CLI, Qwen Code, Kilo Code, Veai и GitHub Copilot CLI — там, где агент это поддерживает. Как подключить самих агентов к IDE, описано в разделе Подключение агентов.

Подключение Spring MCP​

Слой MCP приходит вместе с плагином Amplicode: в приветственном экране Amplicode есть действие Set Up Spring Agent, которое подключает MCP-инструменты — после этого навыки получают структуру проекта из IDE.

В OpenIDE Pro плагин Amplicode входит в поставку — Spring-инструменты Pro работают через него, отдельно его покупать не нужно. Приветственную вкладку Spring Agent Toolkit можно открыть повторно: дважды нажмите Shift и наберите «Spring Agent Toolkit».

Инструкция вендора: amplicode.ru/documentation/spring-agent.

Как это выглядит в работе​

Задача формулируется по-человечески:

Добавь эндпоинт, который возвращает все заказы клиента по его id.

Дальше агент проходит её шагами, каждый из которых закрывает свой навык:

  1. spring-explore — структура проекта, сущности, репозитории, существующие эндпоинты.
  2. spring-data-jpa или spring-data-jdbc — правила слоя доступа к данным.
  3. dto-creator и mapper-creator — типы ответа и преобразование, если они нужны.
  4. crud-rest-controller — REST-слой.
  5. connekt-script-writer — HTTP-скрипт, который проверяет получившийся эндпоинт.

Агент задаёт недостающие вопросы, переиспользует соглашения проекта и не смешивает несовместимые подходы Spring в одном изменении.

Результат всё равно нужно перечитать: см. Рабочее окружение — дифф, инспекции и запуск приложения находятся в той же IDE.

Частые вопросы​

Amplicode нужно покупать отдельно, чтобы работал Spring MCP?​

Нет. В OpenIDE Pro Amplicode входит в поставку полностью, отдельная лицензия не нужна.

Как снова открыть приветственную вкладку Spring Agent Toolkit?​

Дважды нажмите Shift и наберите «Spring Agent Toolkit».

Что дальше​