API SDK Generator 技能：从 OpenAPI 生成 TypeScript 客户端

Claude Code 安装步骤

从 GitHub 固定提交获取完整的 `plugins/api-development/api-sdk-generator/skills/generating-api-sdks` 目录。
复制到目标项目的 `.claude/skills/`，确认 `.claude/skills/generating-api-sdks/SKILL.md`，再从项目根目录启动 Claude Code，输入 `/generating-api-sdks`。

用 Claude Code 将接口契约变成有类型的客户端方法和响应对象，在本地样例中验证调用与错误处理。

为 GET /shipments/{id} 定义 operationId=getShipment，响应有 id 和 status。生成 TypeScript 客户端，在测试中读取 s1 的 status，并处理查询 missing 的 404。

生成方法的参数与字段有类型，s1 返回可核对的状态，404 进入项目的错误处理路径。

GitHub 原文 · 更新日期 2026-11-13

准备 OpenAPI 3 文档、本地 API 和项目固定版本的 TypeScript SDK 生成器。示例使用合成发货记录。

优先放到生成器支持的配置或独立封装，避免重新生成时覆盖手写逻辑。