用途：为 RESTful API 创建、维护和验证 OpenAPI 3.1 规范，可用于从零编写 API 文档、从既有代码生成规范、设计优先地定义 API 契约、校验实现是否符合规范、从规范生成客户端 SDK，以及搭建 API 文档门户。
主要能力：介绍 OpenAPI 3.1 的基本结构（openapi、info、servers、paths、components 等字段）；区分三种设计方式，设计优先（先写规范再写代码，适合新 API 与契约）、代码优先（从代码生成规范，适合既有 API）、混合（在代码中标注再生成规范，适合演进中的 API）。提供模板库与详细示例，具体模板放在 references/details.md，需要时查阅该文件。
使用方式：按资料所述编写或生成规范，并结合最佳实践维护。建议使用 $ref 复用 schema、参数与响应；添加真实示例值；记录所有可能的错误码；对 API 做版本管理（放在 URL 或请求头）；规范变更使用语义化版本。避免使用含糊描述、遗漏安全方案、忽略 nullable 的显式声明、混用命名风格、硬编码 URL（改用 server variables）。
适用场景：新 API 的契约设计、既有 API 的文档补全、SDK 生成、规范与实现的合规校验、文档门户建设。
限制：资料未给出具体的安装命令、运行命令、收费方式、价格、平台支持或效果数据，暂未提供；上述内容仅为该技能的说明与建议，实际使用需以官方资料为准。