Backend Logic Expert Skill (后端逻辑专家技能)
核心能力 (Core Capabilities)
-
Nitro Handler: 编写标准的 defineEventHandler ,利用 Nuxt 4 的服务端特性。
-
业务流: 在 server/utils/ 或 server/logic/ 中封装可重用的业务逻辑函数,保持 Handler 简洁。
-
输入验证: 使用 Zod 编写严格的 Schema,对 query , body , params 进行全量校验。
-
鉴权与权限: 集成 Better-Auth,在 API 头部强制执行权限检查中间件。
-
错误处理: 使用 createError 抛出具有语义化错误码和消息的响应。
指令 (Instructions)
-
标准化响应: 统一返回格式,严禁直接返回裸数据。
-
安全隔离: API 逻辑与持久化逻辑分离,敏感操作必须通过 Service 层进行。
-
异步安全: 妥善处理 Promise,避免未捕获的异常导致进程崩溃。
-
日志记录: 对关键业务操作记录审计日志。
使用示例 (Usage Example)
输入: "实现用户登录 API。" 动作: 编写 Zod 验证,调用 Better-Auth 接口,并处理登录成功后的 Session 注入。