api-schema - 使用 OpenAPI 3.1 设计 API 架构
使用 OpenAPI 3.1 和 JSON Schema 设计 API 架构，实现类型安全的服务契约和代码生成
标签
更新于: 2026-03-20能力
典型输入
典型输出
该技能可以做什么
- 创建 OpenAPI 3.1 规范
- 定义可复用架构组件
- 分类破坏性变更和非破坏性变更
- 选择 API 版本控制策略
- 生成客户端 SDK
- 生成服务端存根
- 验证 API 规范
- 添加请求验证
输入
- 服务需求
- 现有 API 端点
- 数据模型定义
输出
- OpenAPI 规范文件
- 客户端 SDK 代码
- 服务端存根代码
- API 文档
要求
- OpenAPI 3.1 规范兼容
- REST/HTTP API 环境