$npx -y skills add lightpointventures/claude-code-starter --skill api当用户想写接口、创建 API、生成后端端点、做增删改查接口时使用 — 生成 RESTful API 端点,包含路由、验证和错误处理
| 1 | # 生成 API 接口 |
| 2 | |
| 3 | 帮用户快速生成一个规范的 API 端点。 |
| 4 | |
| 5 | ## 步骤 |
| 6 | |
| 7 | ### 1. 确定接口需求 |
| 8 | |
| 9 | 如果用户已经说了,直接开始。否则问: |
| 10 | |
| 11 | > 你需要什么 API?告诉我: |
| 12 | > - 管理什么资源?(比如用户、文章、订单) |
| 13 | > - 需要哪些操作?(查询列表、查询详情、创建、更新、删除) |
| 14 | |
| 15 | ### 2. 检测技术栈 |
| 16 | |
| 17 | 查看项目中的后端框架: |
| 18 | - Python: FastAPI / Flask / Django |
| 19 | - Node.js: Express / Nest / Hono |
| 20 | - 没有后端 → 推荐 FastAPI(Python)或 Express(Node.js),问用户选哪个 |
| 21 | |
| 22 | ### 3. 生成代码 |
| 23 | |
| 24 | 为每个操作生成完整的端点: |
| 25 | |
| 26 | - **路由定义** — RESTful 风格(GET /users, POST /users, GET /users/:id 等) |
| 27 | - **请求验证** — 参数类型检查、必填验证、格式校验 |
| 28 | - **业务逻辑** — 用注释标注"在这里写业务逻辑",提供示例代码 |
| 29 | - **错误处理** — 统一的错误响应格式,常见错误码(400、404、500) |
| 30 | - **响应格式** — 统一的 JSON 响应结构 |
| 31 | |
| 32 | ### 4. 验证 |
| 33 | |
| 34 | 启动服务,用 curl 或测试工具验证接口可以正常响应。 |
| 35 | |
| 36 | > API 已生成,接口如下: |
| 37 | > (列出所有端点和方法) |
| 38 | > 用 /test 可以生成接口测试。用 /database 连接真实数据库。 |