用途:该技能面向 REST 与 GraphQL API 设计,帮助构建直观、可扩展、易维护的接口,适用于设计新 API、重构现有 API、制定团队接口规范、实现前评审规格、在 API 范式之间迁移(如 REST 转 GraphQL)、编写开发者友好的文档,以及为移动端或第三方集成等场景优化接口。
不适用场景:仅需要特定框架的实现指导、只做基础设施工作且不涉及接口契约、无法修改或版本化公开接口。
使用方式:按步骤定义消费者、用例与约束;选择 API 风格并建模资源或类型;明确错误、版本、分页与认证策略;用示例验证并检查一致性。
资源:resources/implementation-playbook.md 提供详细模式、检查清单与模板。
限制:资料未提供具体代码示例、命令、收费与平台信息。