iiuniversitet.ruЦентр обучения нейросетямОткрыть каталог

OpenAPI-спецификация

Генерирует или обновляет OpenAPI/Swagger по коду.

СкиллРазработано в iiuniversitetCodexНаш материалНужен терминалПроверка не требуется
Скачать архив
Что делает
Генерирует или обновляет OpenAPI/Swagger по коду.
Когда брать
Когда вы просите: «опиши API в Swagger» или «openapi-спецификация».
Пример запроса
$openapi-spec опиши API в Swagger

Как включить

  1. Скачайте архив и распакуйте его.
  2. Положите папку openapi-spec в ~/.agents/skills/.
  3. Вызовите скилл командой $openapi-spec или найдите его через /skills.

Текст

---
name: openapi-spec
description: "Генерирует или обновляет OpenAPI/Swagger по коду. Используй, когда пользователь просит: «опиши API в Swagger» или «openapi-спецификация». Не используй для задач вне этой темы."
---

OpenAPI-спецификация

Генерирует или обновляет OpenAPI/Swagger по коду.

Перед началом

Прочитай AGENTS.md и README, определи стек, команды сборки и тестов. Работай в текущей ветке, не трогай несвязанные файлы.

Порядок работы

  1. Просканировать роуты.
  2. Описать схемы.
  3. Добавить примеры.
  4. Провалидировать спецификацию.
  5. Проверь результат по правилам ниже и кратко опиши, что сделано.

Формат результата

openapi.yaml.

Правила

  • Валидируй все входные данные.
  • Секреты — только из переменных окружения.
  • Каждый эндпоинт покрыт тестом.

Пример вызова

$openapi-spec опиши API в Swagger

Разработано в iiuniversitet — https://iiuniversitet.ru/?utm_source=bonus&utm_medium=skill&utm_campaign=katalog&utm_content=openapi-spec

Автор: iiuniversitet. Каталог скиллов iiuniversitet.