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-controller | REST-контроллеры с CRUD-эндпоинтами поверх репозитория, с DTO, маппингом и пагинацией |
dto-creator | DTO для сущности: 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.
Дальше агент проходит её шагами, каждый из которых закрывает свой навык:
spring-explore— структура проекта, сущности, репозитории, существующие эндпоинты.spring-data-jpaилиspring-data-jdbc— правила слоя доступа к данным.dto-creatorиmapper-creator— типы ответа и преобразование, если они нужны.crud-rest-controller— REST-слой.connekt-script-writer— HTTP-скрипт, который проверяет получившийся эндпоинт.
Агент задаёт недостающие вопросы, переиспользует соглашения проекта и не смешивает несовместимые подходы Spring в одном изменении.
Результат всё равно нужно перечитать: см. Рабочее окружение — дифф, инспекции и запуск приложения находятся в той же IDE.
Частые вопросы
Amplicode нужно покупать отдельно, чтобы работал Spring MCP?
Нет. В OpenIDE Pro Amplicode входит в поставку полностью, отдельная лицензия не нужна.
Как снова открыть приветственную вкладку Spring Agent Toolkit?
Дважды нажмите Shift и наберите «Spring Agent Toolkit».