OpenAPI-спецификация
Генерирует или обновляет OpenAPI/Swagger по коду.
СкиллРазработано в iiuniversitetCodexНаш материалНужен терминалПроверка не требуется
- Что делает
- Генерирует или обновляет OpenAPI/Swagger по коду.
- Когда брать
- Когда вы просите: «опиши API в Swagger» или «openapi-спецификация».
- Пример запроса
- $openapi-spec опиши API в Swagger
Как включить
- Скачайте архив и распакуйте его.
- Положите папку
openapi-specв~/.agents/skills/. - Вызовите скилл командой
$openapi-specили найдите его через/skills.
Текст
---
name: openapi-spec
description: "Генерирует или обновляет OpenAPI/Swagger по коду. Используй, когда пользователь просит: «опиши API в Swagger» или «openapi-спецификация». Не используй для задач вне этой темы."
---
OpenAPI-спецификация
Генерирует или обновляет OpenAPI/Swagger по коду.
Перед началом
Прочитай AGENTS.md и README, определи стек, команды сборки и тестов. Работай в текущей ветке, не трогай несвязанные файлы.
Порядок работы
- Просканировать роуты.
- Описать схемы.
- Добавить примеры.
- Провалидировать спецификацию.
- Проверь результат по правилам ниже и кратко опиши, что сделано.
Формат результата
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.