用途:该技能聚焦单一职责——API 契约与协议设计,适用于 REST、gRPC、GraphQL 及混合协议场景,帮助生成端点、OpenAPI 规范与安全配置。
主要能力:输入参数 api_context 为必填对象,含 protocol(REST/gRPC/GraphQL/hybrid)、resources(资源名需匹配 ^[a-z][a-z0-9-]*$,至少一项)、consumers(web、mobile、third_party、internal、iot)、security(auth_method 可选 oauth2、api_key、jwt、mtls,rate_limiting 默认 true)与 constraints(max_latency_ms、backward_compatible 默认 true)。校验规则要求资源名小写连字符,且 consumers 含 third_party 时必须设置认证方式。输出包含 endpoints(method、path、请求/响应 schema、状态码)、openapi_spec(YAML)与 security_config(auth、rate_limits、cors)。
设计模式:REST 采用复数名词、层级路径、kebab-case,规范 HTTP 方法与状态码;gRPC 覆盖一元、服务端流、客户端流与双向流,建议 proto3、包名 company.service.v1、保留已删除字段号;GraphQL 区分类型、查询、变更、订阅与输入类型,并建议查询深度限制、复杂度分析、字段级授权与持久化查询。另含重试配置(最大 3 次、指数退避、可重试 429/502/503/504、幂等键 Idempotency-Key)、日志与指标(api_request_total、api_request_duration_seconds 等)以及常见问题排查清单。
使用方式:通过 Skill("api-architecture") 调用,传入符合 schema 的 api_context。
限制:资料未提供具体安装命令、收费方式、平台支持范围与实际运行效果,暂未提供。