用途:当用户要求“创建 API 端点”“构建 REST API”、开发后端新功能、为现有 API 增加端点,或涉及 API、endpoint、route、REST、CRUD 操作时使用。为每个端点生成路由处理器(含正确 HTTP 方法)、输入校验(请求体、参数、查询)、认证与授权检查、业务逻辑、错误处理、响应格式化、API 文档,以及在被要求时提供测试。
主要能力与用法:路由定义支持 Express 的 router.post('/api/users', authenticate, validateUser, createUser) 和 Fastify 的 fastify.post('/api/users', { preHandler: [authenticate], schema: userSchema }, createUser)。校验需在处理前进行,检查 email 含 @、name 至少 2 字符、password 至少 8 字符等,失败返回 400。处理程序内先查重,重复返回 409,密码用 bcrypt.hash 加密,创建后剔除密码再返回 201。状态码约定:200 成功、201 创建、204 删除、400 校验失败、401 未认证、403 无权限、404 未找到、409 冲突、500 服务器错误。响应统一为 success/data 或 error/details,分页返回 pagination(page、limit、total、pages)。安全清单涵盖认证、资源归属授权、全字段校验、参数化查询防 SQL 注入、公开端点限流、不返回密码或令牌、配置 CORS、设置请求体大小限制;集中式错误处理在生产环境不泄露细节。还包含 CRUD 路径、分页、过滤排序、JSDoc 文档模板和基于 supertest 的测试示例。
限制:仅适用于与上述范围明确匹配的任务;输出不能替代具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。