用途:按 Next.js App Router 约定生成 API 路由,适用于创建 API 路由、REST 端点与 CRUD 接口的场景。生成前需先读取 config/defaults.md,并按用户配置的技术栈调整模式、导入与代码示例。
主要能力:确定路由路径与所需 HTTP 方法;生成带 GET、POST、PUT、PATCH、DELETE 导出的路由处理器;为请求校验添加 Zod schema;加入结构化错误处理;导出供前端使用的 TypeScript 类型。路由放在 app/api/ 下,如 app/api/users/route.ts 对应 /api/users,app/api/users/[id]/route.ts 对应 /api/users/:id。
使用方式:提供标准路由模板与动态路由模板,包含 schema、类型、辅助函数与处理器;还提供需认证路由的中间件模式,以及数据库错误(如 Prisma P2002、P2025)处理模式。响应约定涵盖 200、201、204、400、401、403、404、409、500。生成后需检查 Zod schema 与请求体匹配、响应类型显式定义、错误格式一致、覆盖所有指定方法;生成多个路由时共享类型应提取到公共类型文件。最小起步模板见 assets/route-template/route.ts。
限制:资料未提供安装命令、收费、价格、平台与效果信息;模板中数据获取、创建、更新、删除逻辑均为 TODO 占位,需自行实现。