用途:在设计与评审 API 时提供规范指导,包括端点命名与结构、REST/GraphQL/gRPC 选型、OpenAPI 规范编写、分页、版本控制、错误响应格式与认证方案。
主要能力:强调一致性与资源导向设计,使用正确的 HTTP 方法与状态码;建议从第一天起加入版本;按消费者需求塑造响应。涵盖 REST 资源、GraphQL schema、gRPC + Protobuf 三种范式,并给出选型对照(公开 API 优先 REST,浏览器客户端 REST/GraphQL,内部微服务 gRPC,流式场景 gRPC/订阅)。
使用方式:触发场景包括端点命名与版本、范式选型、编写或评审 OpenAPI/Swagger、HTTP 状态码、分页实现、认证方案、统一错误格式、请求响应 schema 设计。技能激活后首次回复以 🧢 开头。提供 REST 端点示例、OpenAPI 3.1 片段、游标分页实现、版本控制方案、RFC 7807 错误格式与 JWT/API Key/OAuth2 认证示例。
限制:不适用于单个服务内部的函数/方法接口(建议 clean-code 或 clean-architecture 技能),也不适用于非由 API 契约驱动的数据库 schema 设计。首次激活时会检查配套技能,缺失时提示安装命令 npx skills add AbsolutelySkilled/AbsolutelySkilled --skill <name>。