CD openapi

Генерация OpenAPI в Vovk.ts — как спецификация OpenAPI 3.x выводится из процедур + схем валидации, семейство декораторов `@operation` (`@operation({...})` для summary/description/tags/security/deprecated, `@operation.error(status, message)` для ответов об ошибках, `@operation.tool({...})` для метаданных AI-инструментов), настройка верхнего уровня `outputConfig.openAPIObject` (info, servers, license, tags, security, components), переопределения для каждого сегмента, доступ к спецификации из кода (`@/client/openapi`), обслуживание JSON спецификации из контроллера и рендеринг с помощью **Scalar** (основной / рекомендуемый UI документации — использует примеры кода TypeScript / Python / Rust, генерируемые Vovk через `x-codeSamples`) или альтернатив, таких как Redoc / Swagger UI. Используйте, когда пользователь запрашивает «документацию API», «документацию Scalar», «Swagger», «спецификацию OpenAPI», «документировать мой API», «сгенерировать OpenAPI из моих контроллеров», «добавить блок info/title/servers», «документацию для конкретного сегмента», «предоставить OpenAPI по адресу /api/docs», «bearer auth в спецификации», «документировать возможные ошибки», «сделать конечную точку устаревшей». НЕ охватывает создание процедур → передать навыку `procedure`. НЕ охватывает вывод AI-инструментов через `deriveTools` → передать навыку `tools` (хотя `@operation.tool` упоминается здесь, так как это часть семейства декораторов). НЕ охватывает импорт сторонних OpenAPI → передать навыку `mixins`.

машинный переводПоказать оригиналСкрыть оригинал«Vovk.ts OpenAPI generation — how the OpenAPI 3.x spec is derived from…»

Vovk.ts OpenAPI generation — how the OpenAPI 3.x spec is derived from procedures + validation schemas, the `@operation` decorator family (`@operation({...})` for summary/description/tags/security/deprecated, `@operation.error(status, message)` for error responses, `@operation.tool({...})` for AI tool metadata), top-level `outputConfig.openAPIObject` configuration (info, servers, license, tags, security, components), per-segment overrides, accessing the spec from code (`@/client/openapi`), serving the spec JSON from a controller, and rendering it with **Scalar** (the primary / recommended docs UI — picks up the TypeScript / Python / Rust code samples that Vovk generates via `x-codeSamples`) or alternatives like Redoc / Swagger UI. Use whenever the user asks for "API docs", "Scalar docs", "Swagger", "OpenAPI spec", "document my API", "generate OpenAPI from my controllers", "add an info/title/servers block", "segment-specific docs", "expose OpenAPI at /api/docs", "bearer auth in the spec", "document possible errors", "deprecate an endpoint". Does NOT cover procedure authoring → hand off to `procedure` skill. Does NOT cover AI tool derivation via `deriveTools` → hand off to `tools` skill (though `@operation.tool` is mentioned here since it's part of the decorator family). Does NOT cover third-party OpenAPI imports → hand off to `mixins` skill.

Генерация OpenAPI в Vovk.ts — как спецификация OpenAPI 3.x выводится из процедур + схем валидации, семейство декораторов @operation (@operation({...}) для…

Как процесс D 47/100 · Процесс не доведён — слабые места: результат и критерий готовности, входы и предусловия, ошибки и развилки