用途:该技能面向 OpenAPI/Swagger 规范编写,可从现有 API 代码生成 OpenAPI 3.0+ 规范,并用于增强、文档化与校验。
主要能力:分析现有 API 代码,提取端点、方法与参数;记录请求/响应模式;生成符合 OpenAPI 3.0+ 的规范;包含认证方案。增强方面可补充详细描述、示例值、错误响应、校验规则与弃用警告。文档方面可生成交互式 API 文档、客户端 SDK、API 参考指南,并导出多种格式。校验方面可检查 OpenAPI 合规性、校验模式定义、确保一致性并验证示例。
使用方式:以 @openapi-generator 调用,支持参数 --from-code、--validate、--generate-docs、--format yaml。资料给出 Express.js 结合 swagger-jsdoc 的生成示例,以及 OpenAPI 3.0 规范结构示例,涵盖 info、servers、tags、paths、components(schemas、responses、securitySchemes)与 security 等部分。
适用场景:为已有服务补全接口文档、统一规范、生成 SDK 或参考文档、在提交前做规范校验。
限制:资料未提供安装命令、具体运行环境要求、收费与价格信息,也未说明支持的语言或框架完整清单,这些暂未提供。