全部技能
api-designer
起草 OpenAPI 3.1 规范,含资源模型、端点、错误响应和版本策略。
- 属于 Jeffallan/claude-skills
- 7100次安装
- 开发工具 · 后端开发
适合什么时候用
你已有领域模型或功能清单,但还没有确定的 API 契约,需要在写代码前定好端点、分页和错误格式。
举个例子
你对 AI 说
用 api-designer 技能为书店设计 REST API:图书、作者和订单,使用游标分页和 RFC 7807 错误格式,输出 OpenAPI 3.1 规范。
你会拿到
- 资源模型表
- OpenAPI 3.1 YAML 规范
- 错误响应目录
它会怎么做
- 先画出资源模型和关系图,再开始写规范。
- 包含用 Redocly 做 lint、用 Prism 启动 mock 服务来验证契约的步骤。