SuperAPI AI 工具集

sdk-builder

编程与开发

查看项目

更新于 10-16 02:38

技能介绍

用途:sdk-builder 是客户端库/SDK 架构设计技能,强调“让 SDK 像语言原生特性而非 HTTP 包装”,目标是降低集成摩擦,提升开发者体验。适用任务包括 SDK 设计、客户端库、API 客户端、开发者体验与版本管理。

主要能力与原则:易用且不易误用;类型作为第一层文档;合理默认值并为高级用户保留逃生通道;错误信息应指向解决方案;版本管理是承诺而非建议。其核心观点是,多数 SDK 失败源于摩擦而非缺陷:五分钟即可集成的 SDK 胜过功能更多但需一小时集成的方案。

使用方式:需将提供的参考文件作为该领域事实来源。创建时查阅 references/patterns.md,按其中模式构建,如有特定模式则忽略通用做法;诊断时查阅 references/sharp_edges.md,用于解释关键失败及其原因与风险;评审时查阅 references/validations.md,用严格规则客观校验用户输入。若用户请求与参考文件冲突,应依据参考内容礼貌纠正。

适用场景:SDK 与客户端库架构设计、API 人体工学优化、版本策略、开发者体验改进与设计评审。

限制与边界:不覆盖后端实现、API 服务端设计与基础设施。后端 API 交由 api-designer,语言细节交由 python-craftsman,文档交由 docs-engineer,测试交由 test-architect。具体安装命令、平台与收费方式暂未提供。