EasyYapi — скилл
EasyYapi выгружает API из кода Java и Kotlin в YApi, Postman и OpenAPI, а скилл помогает агенту писать правила выгрузки.
- 490 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Агент правит файлы правил в проекте, а выгрузка отправляет описания эндпоинтов во внешние платформы.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/easyyapiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент правит файлы правил в проекте, а выгрузка отправляет описания эндпоинтов во внешние платформы.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
EasyYapi — плагин IntelliJ IDEA, который читает контроллеры Spring MVC, Feign, JAX-RS и gRPC в проектах на Java и Kotlin и выгружает документацию в YApi, Postman, Markdown, cURL, OpenAPI 3.0.3, Hoppscotch и ApiPost. В окне API Explorer эндпоинты ищут и вызывают прямо из IDE. Для агентов есть скилл `easy-yapi-assistant`: он помогает писать правила в папке `.easyapi/` (переименование полей, заголовки, игнорируемые классы) по тем же справочникам, что и встроенный ассистент. Если в IDE включен MCP-сервер (IntelliJ IDEA 2025.2 и новее), агент вызывает `easyapi_scan_endpoints` и `easyapi_export`.
Для кого. Java- и Kotlin-разработчикам на Spring, которые ведут документацию API в YApi или Postman и хотят доверить агенту настройку правил выгрузки.
Подходит, если
- Фильтр или обертка ответа меняет контракт, и в выгрузку нужно добавить правило.
- Документацию контроллеров отправляют в YApi или Postman из IDE одной командой.
- Поля класса переводят в JSON, JSON5, YAML или properties.
- Агент по запросу перечисляет эндпоинты проекта и выгружает их через MCP IDE.
Не подходит, если
- Проект не на JVM: плагин разбирает код Java, Kotlin, Scala и Groovy.
- Нет IntelliJ IDEA 2025.2 или новее: основная сборка рассчитана на нее.
- Обычные эндпоинты Spring уже выгружаются без правил, а скилл нужен для нестандартных соглашений.
Пример запроса к агенту
Проверь, какие эндпоинты EasyYapi выгрузит из этого модуля, и добавь правило для общего заголовка авторизации.Ограничения
Плагин работает внутри IntelliJ IDEA 2025.2 и новее, без IDE скилл ничего не выгружает. MCP-инструменты доступны только при включенном встроенном MCP-сервере IDE. Выгрузка в YApi, Postman, Hoppscotch и ApiPost отправляет описания эндпоинтов на выбранную платформу, а форматы Hoppscotch, OpenAPI и ApiPost README помечает как бета. Лицензия AGPL-3.0 накладывает условия на производные работы, а плагин и скилл ставятся отдельными шагами.
Как отключить. Удалите скилл `easy-yapi-assistant` из каталога скиллов агента и отключите или удалите плагин EasyApi в настройках IDE.
Частые вопросы
Как поставить скилл?
Выполните `npx skills add tangcent/easy-yapi -g -y`. Если агент не умеет ставить скиллы, вставьте в чат подсказку из README: она загружает только папку `skills/easy-yapi-assistant/`.
Куда выгружает плагин?
В YApi, Postman, Markdown, cURL и HTTP Client IDE, а в бета-режиме еще в Hoppscotch, OpenAPI и ApiPost.
Какие фреймворки понимает?
Spring MVC, Spring Cloud OpenFeign, JAX-RS (Quarkus и Jersey) и gRPC. Для остальных соглашений есть режим правил.
Что дает MCP?
При включенном MCP-сервере IDE агент вызывает `easyapi_scan_endpoints` (только чтение) и `easyapi_export` (выгрузка в YApi без диалога).
Чем скилл отличается от встроенного ассистента?
Встроенный агент работает через PSI IDE, а скилл читает файлы проекта напрямую и подходит внешним ассистентам вроде Cursor или Cline.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыНабор из 16 скиллов для Spring Boot: агент сначала изучает приложение, потом правит JPA, DTO, REST, Security, Kafka и тесты.
Скилл FastAPI
FastAPI skill
Официальный скилл FastAPI, который поставляется вместе с пакетом и учит агента писать код под установленную версию
Шесть скиллов для разработки на Java: Spring Boot 4, проверка Spring Modulith, jSpecify, ревью кода и генератор проектов Progen.
Набор скиллов для Claude Code и Codex, которые учат агента писать Spring Boot по вашим конвенциям и шаблонам
Терминальный REST-клиент с коллекциями в YAML рядом с кодом и скиллом, по которому агент сам пишет и гоняет запросы
Набор из 14 скиллов для Java Spring Boot: от анализа требований и генерации кода до тестов, ревью и Docker-развертывания.
Коротко о README
Основное в README — плагин IntelliJ с выгрузкой API, проводником эндпоинтов и конвертацией полей. Раздел Skills описывает внешний скилл и установку через `npx skills add`.