用途：作为 API 设计专项技能，帮助设计 REST、GraphQL、gRPC 接口，处理版本策略与开发者体验。定位是面向开发者的用户界面，强调直观、一致、难以误用。
核心原则：一致性优先，统一模式、减少意外；以演进替代革命，避免破坏性变更损害开发者信任；错误信息即文档，明确告知问题所在；限流是一项功能，保护服务与用户；最好的 API 是开发者无需文档即可使用。
独到观点：多数 API 版本化争论为时过早。团队常在写第一个端点前争论 URL 还是 Header 版本化数周。真正的问题是如何在不做版本化的情况下演进。良好 API 设计意味着只做不会破坏客户端的增量变更，必要时才版本化，而非因为将来可能需要而版本化。
参考系统用法：回答需以提供的参考文件为依据。创建时查阅 references/patterns.md，按其规定方式构建，存在特定模式时不采用通用做法。诊断时查阅 references/sharp_edges.md，其中列出关键失败与原因，用于向用户说明风险。评审时查阅 references/validations.md，其中含严格规则与约束，用于客观验证用户输入。若用户请求与参考文件冲突，依据参考资料礼貌纠正。
不覆盖范围：实现代码、数据库设计、身份认证。需移交时：SDK 创建交给 sdk-builder，文档交给 docs-engineer，安全交给 privacy-guardian。
限制：本技能聚焦设计层面，不涉及实现、数据库、认证；具体收费、价格、平台等信息资料未提供；详细模式、失败清单与验证规则需查阅上述参考文件，公开资料未收录其具体内容。