用途：该技能聚焦 REST 与 GraphQL 的 API 设计原则，目标是构建直观、可扩展、可维护且对开发者友好的接口。适用场景包括设计新 API、重构现有 API、制定团队设计标准、实现前评审规格、在 REST 与 GraphQL 之间迁移、编写文档，以及针对移动端或第三方集成做优化。
主要能力：REST 部分涵盖面向资源的架构（资源用名词、动作用 HTTP 方法）、HTTP 方法语义、URL 版本、请求头版本、查询参数版本等版本化策略，以及资源集合设计、分页与过滤、错误处理与状态码、HATEOAS 等模式。GraphQL 部分涵盖 schema 优先开发、类型与查询/变更/订阅结构、Relay 风格游标分页、解析器设计、DataLoader 防止 N+1 问题等。
使用方式：技能建议先澄清领域与约束，再确定设计；若环境提供 mcp-feedback-enhanced 工具（如 ask_followup_question），可用其提问或展示方案供评审，否则使用普通对话。资料还列出参考文件与模板，如 references/rest-best-practices.md、references/graphql-schema-design.md、references/api-versioning-strategies.md，以及 assets/rest-api-template.py、assets/graphql-schema-template.graphql、assets/api-design-checklist.md 和 scripts/openapi-generator.py。
限制：资料未提供该技能的安装命令、收费方式、支持平台或实际效果说明，这些信息暂未提供。