API 路由脚手架
从资源规格脚手架完整 CRUD 路由（handler、验证、类型、测试）。
代码生成进阶
为什么
GitHub 2024 Octoverse 报告显示生成式 AI 项目贡献量激增 59%，平台 AI 项目总数增长 98%。CRUD 路由重复但易错（验证、状态码、错误结构）。
从一个规格脚手架四件套确保一致并省去手写劳作。
何时使用
标准 CRUD 新资源用此。定制端点跳过。
如何做
1. 定义资源：名、字段 + 类型、zod schema。
2. 提示："为 Books 脚手架 CRUD：路由、zod schema、类型、测试；遵循 health.ts"。
3. 逐生成文件审查；调整错误结构。
4. 跑 tsc + 测试；将路由接入应用。
5. 每文件一 commit 或一次脚手架 commit。
示例
资源：Book { id: string; title: string; author: string }
提示："@folder src/api 为 Book 脚手架 CRUD 遵循 health.ts；
zod schema 用于 create/update；无效 400；缺失 404；各测试。"
生成：books.ts（路由）、books.test.ts、schema.ts — 全一致。
常见问题
- ⚠错误结构不一致：脚手架异于现有路由 — 固定模板。
- ⚠错误：幻觉 API：模型调用不存在的函数 → 对照真实库文档检查并在 package.json 锁定版本。
- ⚠Error: Cannot find module 'xxx' → `npm install xxx`；生成代码常导入项目尚未安装的包。
最佳实践
- ✓固定参考路由（如 health.ts）作模板。
- ✓一次脚手架要求 schema + 测试 + 路由以保持一致。
- ✓用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。
常见问题解答
什么是API 路由脚手架？
从资源规格脚手架完整 CRUD 路由（handler、验证、类型、测试）。 它可帮助开发者快速理解 API 路由脚手架 的核心价值与适用场景。
如何开始使用API 路由脚手架？
开始使用 API 路由脚手架，建议先掌握以下要点：定义资源：名、字段 + 类型、zod schema。
API 路由脚手架 的常见误区有哪些？
使用 API 路由脚手架 时常遇到的问题包括：错误结构不一致：脚手架异于现有路由 — 固定模板。；错误：幻觉 API：模型调用不存在的函数 → 对照真实库文档检查并在 package.json 锁定版本。；Error: Cannot find module 'xxx' → `npm install xxx`；生成代码常导入项目尚未安装的包。。
API 路由脚手架 的最佳实践是什么？
API 路由脚手架 的最佳实践包括：固定参考路由（如 health.ts）作模板。；一次脚手架要求 schema + 测试 + 路由以保持一致。；用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。。
如何深入学习API 路由脚手架？
从官方文档入手，再在 GitHub 上搜索真实示例；先在小实验仓库验证模式，再应用到生产代码。