用途：本技能面向 SDK 设计与开发者体验（DX），目标是让 SDK 用起来顺手、降低摩擦，使开发者愿意主动推荐。
主要能力：
- API 设计原则：为常见场景优化（最少代码完成高频调用）、渐进式披露（从简单到完整控制）、快速且清晰地失败、提供合理默认值（自动重试、超时、JSON 内容类型、标准认证头、连接池）。
- 错误信息：每条错误应回答发生了什么、为什么、如何修复；区分认证、授权、校验、未找到、限流、服务端等错误类型，并在错误中附带字段、值、期望格式与文档链接。
- 类型安全：为输入输出定义显式类型，使用判别联合表示响应，用枚举/字面量类型约束取值，面向 IDE 自动补全设计。
- IDE 集成：按命名空间组织方法，全面编写 JSDoc/docstring，包含参数说明、返回值、抛出异常与内联示例。
- 版本管理：严格遵循语义化版本，明确破坏性变更范围，提供弃用警告与迁移指南，必要时提供 codemod 自动化迁移脚本。
- 语言习惯：Python 用 snake_case、上下文管理器；JavaScript 用 Promise/async-await；Go 用 error 返回与接口，贴合各生态惯例。
使用方式：作为设计 SDK 时的检查清单与参考规范，配合开发者受众上下文技能先了解目标语言、框架与经验水平。发布前核对文档、类型、错误可修复性、示例测试、变更日志与迁移指南；追求 5 分钟内完成快速上手。
适用场景：设计或重构对外 SDK、编写错误处理与类型定义、制定版本与弃用策略、编写迁移指南。
限制：资料未提供具体收费、价格、平台支持范围与效果数据；相关工具（OpenAPI Generator、Speakeasy、Fern、VCR、WireMock、Pact、TypeDoc、Sphinx、GoDoc、YARD）仅为列举，未给出使用步骤与版本要求。