Генерация OpenAPI-спецификаций по стандарту Zalando

★ 6.7 · vibe-coding

api-spec-openapi — это скилл для Claude Code, который генерирует и проверяет OpenAPI 3.1 спецификации по гайдлайнам Zalando: kebab-case пути, курсорная пагинация, ошибки в формате RFC 9457 problem+json, URL-версионирование и Idempotency-Key для POST. Каждый bounded context оформляется как отдельный YAML-файл с именем вида `<bounded-context>.openapi.yaml` в папке `api-specs/`, готовый к независимой публикации в SmartBear SwaggerHub. Скилл покрывает весь цикл работы с контрактом: создание спецификации из доменных моделей, обновление существующего OpenAPI-файла под конвенции Zalando и ревью на соответствие требованиям по именованию, пагинации, обработке ошибок и безопасности. Подходит командам, которые проектируют API-контракты для микросервисов и хотят соблюдать единый стандарт без ручной проверки каждого правила.