AgentSkillsCN

backend-logic-expert

专注于 Nitro API、业务逻辑封装、Better-Auth 集成与权限校验。

SKILL.md
--- frontmatter
name: backend-logic-expert
description: 专注于 Nitro API、业务逻辑封装、Better-Auth 集成与权限校验。
version: 1.0.0
author: GitHub Copilot

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 注入。