用途:该技能是一个自动激活的 API 技能发现网关,在检测到 API 相关工作时,按需加载 API 设计、认证与实现类技能,避免一次性载入全部索引占用上下文。
主要能力:提供 8 个专项技能的入口,包括 REST API 设计(资源建模、HTTP 语义、URL 约定)、GraphQL schema 设计(类型、解析器、避免 N+1)、API 认证(JWT、OAuth 2.0、API 密钥、会话)、API 授权(RBAC、ABAC、策略引擎、权限系统)、API 限流(令牌桶、滑动窗口等算法)、API 版本化(弃用与向后兼容)、API 错误处理(RFC 7807、校验、标准化响应)以及 API 设计规则(35 条规则)。
使用方式:技能在 Claude Code 检测到 API 相关工作时自动加载;可用 Read ../api/INDEX.md 查看完整分类索引,或按需读取单个技能文件,例如 Read ../api/rest-api-design.md、Read ../api/api-authentication.md、Read ../api/api-authorization.md、Read ../api/api-rate-limiting.md、Read ../api/api-error-handling.md、Read ../api/api-versioning.md、Read ../api/graphql-schema-design.md、Read ../api/api-design-rules.md。文档给出常见工作流组合,如新 REST API(REST 设计→认证→授权)、新 GraphQL API(schema→认证→授权)、API 加固(限流→错误处理→版本化)和完整 API 栈。
适用场景:构建传统 Web 服务、需要简单 CRUD、面向移动端或 SPA、需要缓存与 HTTP 语义时选 REST;客户端需灵活取数、减少过取或欠取、构建聚合层、需要强类型时选 GraphQL。认证解决“你是谁”,授权解决“你能做什么”。公共 API 建议始终实现限流,从第一天采用版本化,并尽早统一错误响应。该技能也常与数据库、测试、前端、基础设施等技能组合使用。
限制:采用渐进式加载,网关约 200 行(约 2K tokens),加载分类索引约 3K tokens,单个技能约 2–3K tokens。具体实现细节、代码示例与各技能完整内容需读取对应文件;公开资料未提供收费、价格、平台支持范围等信息。