API Contract Generator 技能：先定义新接口的请求和响应

Claude Code 安装步骤

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

用 Claude Code 将业务规则变成 OpenAPI 契约和正反例，先让前后端就字段、状态和边界达成一致。

定义 POST /templates 需要 name，允许可选 description。写 201 的 id/name 响应和空名称的 400 响应，再验证两份示例。

契约给出成功和失败形状，前端可先用这两份 fixture 开发，后端有明确验收条件。

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

准备自己的 API 提案和 OpenAPI 工具。示例使用合成清单模板资源。

为实际结构不同的状态写独立 schema。把可共用的标准错误字段放在组件定义。