backend-logic-expert

name	backend-logic-expert
description	专注于 Nitro API、业务逻辑封装、Better-Auth 集成与权限校验。
metadata	{"internal":true}

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)

1. 标准化响应: 统一返回格式，严禁直接返回裸数据。
2. 安全隔离: API 逻辑与持久化逻辑分离，敏感操作必须通过 Service 层进行。
3. 异步安全: 妥善处理 Promise，避免未捕获的异常导致进程崩溃。
4. 日志记录: 对关键业务操作记录审计日志。

使用示例 (Usage Example)

输入: "实现用户登录 API。" 动作: 编写 Zod 验证，调用 Better-Auth 接口，并处理登录成功后的 Session 注入。