用途：为 RESTful API 创建、维护和校验 OpenAPI 3.1 规范，可用于从零编写 API 文档、从现有代码生成规范、设计优先定义 API 契约、校验实现是否符合规范、从规范生成客户端 SDK，以及搭建 API 文档门户。
主要能力：提供 OpenAPI 3.1 结构示例（openapi、info、servers、paths、components 等）；对比三种设计方式——设计优先（先写规范再写代码，适合新 API 与契约）、代码优先（从代码生成规范，适合已有 API）、混合（在代码中加注解再生成，适合演进中的 API）；给出完整 API 规范模板，包含路径、参数、请求体、响应、错误、分页、示例与安全方案（bearerAuth、apiKey）；并给出 Python/FastAPI 代码优先生成示例，使用 Pydantic 模型、枚举、Query/Path 校验与 openapi_tags 等。
使用方式：按资料中的模板编写 YAML 规范，或使用 FastAPI 等框架的自动生成能力，通过模型字段、响应模型和路由注解产出规范。资料未提供具体安装命令或 CLI 用法。
适用场景：新 API 契约设计、已有 API 文档补全、SDK 生成、实现与规范一致性校验、文档门户搭建。
限制：资料仅展示 OpenAPI 3.1 与 FastAPI 示例，未说明其他语言、工具链、收费、平台或效果；具体校验与生成命令暂未提供。