用途：在需要生成完整、可用的 OpenAPI 3.x 或 Swagger 2.0 规范时使用，输入可以是自然语言描述、已有源码或部分规范，也适用于 REST API 文档与端点文档编写。
主要能力：先收集版本（3.x 或 2.0）、输出格式（默认 YAML）、API 用途、端点列表、认证方式、数据模型与已有部分规范，再据此构建规范。可写入 info、servers/host、tags、paths、components/schemas、securitySchemes 等内容，支持 $ref 复用、required 字段、nullable、格式关键字（int32、int64、date、date-time、uuid、email、uri 等），并提供分页、错误对象、时间戳等常用 schema 模式。可从 Express/Koa/Fastify、FastAPI/Flask、Spring Boot、Django REST Framework、Rails 等源码中提取端点与参数；维护安全方案（Bearer、API Key、OAuth 2、Basic、OpenID Connect），并覆盖 200/201/204/400/401/403/404/409/422/429/500 等响应码。完成前检查 version 字段、operationId 唯一、$ref 目标存在、required 完整、示例存在、无孤立 schema 等。
使用方式：由用户描述或提供代码/部分规范触发；输出完整 YAML 或 JSON 代码块，并附端点摘要表，可进一步提出导出文件、用 Spectral 或 swagger-parser 校验、生成 Prism mock 配置或客户端 SDK 桩。
适用场景：REST API 文档、接口规范补全、从代码反推规范。
限制：仅在任务与上游来源及本地项目上下文明确匹配时使用；应用前须核验命令、生成代码、依赖、凭据与外部服务行为；示例不能替代环境相关测试、安全审查或用户对破坏性/高成本操作的批准。费用、价格等信息暂未提供。