用途:在构建 TypeScript SDK、把共享代码抽取为独立包、创建开发者工具库、设计干净的 API 表面或发布到 npm 时使用。技能覆盖从零创建或从现有应用抽取 SDK 的完整生命周期,并提供多篇参考文档。
主要能力与原则:公共 API 只导出使用者需要的内容并隐藏内部实现;为配置、方法、响应和错误提供完整类型覆盖;用带错误码和上下文的类型化错误类表达有意义错误;提供开箱即用的合理默认值;核心 SDK 不依赖框架,框架绑定单独添加。
快速上手清单:分析范围(新建还是从现有应用抽取);设计公共 API 表面(导出、类型、配置);实现带类型方法和错误处理的客户端;配置 ESM/CJS/类型输出(推荐 tsup);编写单元与集成测试及示例;以正确的 package.json exports 字段发布到 npm。
参考文档涵盖:抽取范围与边界、用法查找与分阶段抽取计划、包结构与客户端设计模式、配置与 API 设计、内部架构与最佳实践(HTTP 客户端、状态管理、tree-shaking、环境无关)、类型设计(严格类型、branded 类型、泛型、可辨识联合)、错误处理与异步(错误类层次、重试、请求队列、token 管理)、事件存储与日志、构建工具与输出、打包优化与分发、发布与注册表、CI/CD 与文档。
不适用:消费外部 API 应参考 api-integration 技能;仅做 npm 发布也不适用,因为该技能覆盖完整 SDK 生命周期。资料未提供具体安装命令、代码示例或价格信息。