用途:当需要为某个 REST API 生成客户端 SDK、编写客户端库、创建 API 封装,或从 API 生成 TypeScript 类型、Python 客户端时使用本技能。它面向任意语言生成生产质量的客户端库与 SDK 代码。
主要能力:按统一结构组织 SDK,包含主客户端类(含 base URL、认证、重试)、按 API 资源划分的 resources 文件、请求/响应数据模型、类型化错误类,以及重试与分页工具。提供 Python(httpx)与 TypeScript(fetch)的基础客户端模式,资源类模式(如 UsersResource 的 list/get/create/delete),类型化错误类(401/403/404/422/429/5xx),以及分页辅助函数。
规则:始终为 429 和 5xx 加入指数退避重试;始终包含标识 SDK 名称与版本的 User-Agent 头;所有模型必须带类型(Python 用 dataclass、TypeScript 用 interface、Go 用 struct);资源类应镜像 API 资源层级;为每个生成的类提供用法示例。
限制:仅在任务与上游来源及本地项目上下文明确匹配时使用;应用改动前需验证命令、生成代码、依赖、凭据与外部服务行为;示例不能替代针对具体环境的测试、安全审查,以及对破坏性或高成本操作的用户批准。具体支持的语言范围、安装方式与版本要求暂未提供。