[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MFYWVFNVD85NBN2VQTH774":3,"skill-same:01M6MFYWVFNVD85NBN2VQTH774":73},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":31,"publishedAt":43,"linkOnly":44,"markdownContent":45,"markdownBody":46,"frontMatter":47,"refName":50,"commitSha":51,"skillDirectory":52,"forksCount":53,"repositoryHtmlUrl":54,"repositoryHomepageUrl":55,"ownerHtmlUrl":56,"ownerBlogUrl":57,"ownerDescription":58,"updatedAt":59,"install":60,"resources":72},"01M6MFYWVFNVD85NBN2VQTH774","backend\u002Fapi-development",null,"后端API开发方法论，包括RESTful\u002FGraphQL设计、请求验证、错误处理和安全实现","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FechoVic\u002Fboss-skill\u002Fskill\u002Fskills\u002Fbackend\u002Fapi-development\u002FSKILL.md",[18,23,26],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":27,"categoryName":28,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[32,33,34,35,36,37,38,39,40,41,42],"development","api","backend","backend api","api development","backend api development","design","methodology","安全","true","后端","2026-11-10 10:12:30",false,"---\n\nname: backend\u002Fapi-development\ndescription: 后端API开发方法论，包括RESTful\u002FGraphQL设计、请求验证、错误处理和安全实现\ntype: methodology\nagent: boss-backend\nmetadata:\ninternal: true\n---\n\n# 后端 API 开发方法论\n\n## API 契约管理\n\n### 契约来源\n\n实现 API 前，**必须**阅读 `architecture.md` §5（API 设计），获取：\n- API 规范（RESTful\u002FGraphQL）\n- 接口列表（方法、路径、描述、认证要求）\n- 请求\u002F响应格式约定\n- 错误码规范\n\n### 契约遵守原则\n\n1. **严格实现**：API 端点的方法、路径、参数必须与 architecture.md §5 一致\n2. **响应格式**：遵循统一的成功\u002F错误响应结构\n3. **偏差记录**：如需偏离契约，必须在输出报告中标注原因\n4. **类型导出**：将请求\u002F响应类型导出到共享文件，供前端引用\n\n## RESTful API 设计\n\n### 资源命名规范\n\n| 操作 | HTTP 方法 | 路径             | 说明         |\n| ---- | --------- | ---------------- | ------------ |\n| 列表 | GET       | `\u002Fapi\u002Fusers`     | 获取用户列表 |\n| 详情 | GET       | `\u002Fapi\u002Fusers\u002F:id` | 获取单个用户 |\n| 创建 | POST      | `\u002Fapi\u002Fusers`     | 创建新用户   |\n| 更新 | PUT\u002FPATCH | `\u002Fapi\u002Fusers\u002F:id` | 更新用户     |\n| 删除 | DELETE    | `\u002Fapi\u002Fusers\u002F:id` | 删除用户     |\n\n### 统一响应格式\n\n**成功响应**：\n```json\n{\n  \"success\": true,\n  \"data\": { ... },\n  \"message\": \"Operation successful\"\n}\n```\n\n**错误响应**：\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"VALIDATION_ERROR\",\n    \"message\": \"Invalid input data\",\n    \"details\": [{ \"field\": \"email\", \"message\": \"Invalid email format\" }]\n  }\n}\n```\n\n### 分页规范\n\n**请求参数**：\n```\nGET \u002Fapi\u002Fusers?page=1&pageSize=20&sortBy=createdAt&order=desc\n```\n\n**响应格式**：\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"items\": [...],\n    \"pagination\": {\n      \"page\": 1,\n      \"pageSize\": 20,\n      \"total\": 100,\n      \"totalPages\": 5\n    }\n  }\n}\n```\n\n## 请求验证\n\n### 输入验证层级\n\n1. **路由层**：验证路径参数和查询参数\n2. **中间件层**：验证请求体格式和必填字段\n3. **Service 层**：验证业务规则\n\n### 验证示例\n\n```typescript\n\u002F\u002F 使用验证库（如 Zod、Joi、class-validator）\nimport { z } from 'zod';\n\nconst CreateUserSchema = z.object({\n  name: z.string().min(1).max(100),\n  email: z.string().email(),\n  age: z.number().int().min(0).max(150).optional(),\n});\n\n\u002F\u002F 在路由处理器中验证\napp.post('\u002Fapi\u002Fusers', async (req, res) => {\n  try {\n    const validatedData = CreateUserSchema.parse(req.body);\n    const user = await userService.create(validatedData);\n    res.json({ success: true, data: user });\n  } catch (error) {\n    if (error instanceof z.ZodError) {\n      res.status(400).json({\n        success: false,\n        error: {\n          code: 'VALIDATION_ERROR',\n          message: 'Invalid input data',\n          details: error.errors,\n        },\n      });\n    }\n  }\n});\n```\n\n### 常见验证规则\n\n- **必填字段**：确保关键字段存在\n- **类型检查**：字符串、数字、布尔值、日期\n- **格式验证**：邮箱、URL、手机号、UUID\n- **范围限制**：最小\u002F最大长度、数值范围\n- **业务规则**：唯一性、外键存在性\n\n## 错误处理\n\n### 错误分类\n\n| 错误类型   | HTTP 状态码 | 错误码           | 说明                   |\n| ---------- | ----------- | ---------------- | ---------------------- |\n| 验证错误   | 400         | VALIDATION_ERROR | 输入数据不合法         |\n| 认证错误   | 401         | UNAUTHORIZED     | 未登录或 Token 无效    |\n| 权限错误   | 403         | FORBIDDEN        | 无权限访问资源         |\n| 资源不存在 | 404         | NOT_FOUND        | 请求的资源不存在       |\n| 冲突错误   | 409         | CONFLICT         | 资源冲突（如重复创建） |\n| 服务器错误 | 500         | INTERNAL_ERROR   | 服务器内部错误         |\n\n### 统一错误处理中间件\n\n```typescript\n\u002F\u002F errorHandler.ts\nexport function errorHandler(err: Error, req: Request, res: Response, next: NextFunction) {\n  console.error(err);\n\n  if (err instanceof ValidationError) {\n    return res.status(400).json({\n      success: false,\n      error: {\n        code: 'VALIDATION_ERROR',\n        message: err.message,\n        details: err.details,\n      },\n    });\n  }\n\n  if (err instanceof NotFoundError) {\n    return res.status(404).json({\n      success: false,\n      error: {\n        code: 'NOT_FOUND',\n        message: err.message,\n      },\n    });\n  }\n\n  \u002F\u002F 默认 500 错误\n  res.status(500).json({\n    success: false,\n    error: {\n      code: 'INTERNAL_ERROR',\n      message: 'An unexpected error occurred',\n    },\n  });\n}\n```\n\n## 安全实现\n\n### 认证（Authentication）\n\n**JWT Token 示例**：\n```typescript\nimport jwt from 'jsonwebtoken';\n\n\u002F\u002F 生成 Token\nexport function generateToken(userId: string): string {\n  return jwt.sign({ userId }, process.env.JWT_SECRET!, {\n    expiresIn: '7d',\n  });\n}\n\n\u002F\u002F 验证 Token 中间件\nexport function authMiddleware(req: Request, res: Response, next: NextFunction) {\n  const token = req.headers.authorization?.replace('Bearer ', '');\n\n  if (!token) {\n    return res.status(401).json({\n      success: false,\n      error: { code: 'UNAUTHORIZED', message: 'No token provided' },\n    });\n  }\n\n  try {\n    const decoded = jwt.verify(token, process.env.JWT_SECRET!);\n    req.user = decoded;\n    next();\n  } catch (error) {\n    res.status(401).json({\n      success: false,\n      error: { code: 'UNAUTHORIZED', message: 'Invalid token' },\n    });\n  }\n}\n```\n\n### 授权（Authorization）\n\n**基于角色的访问控制（RBAC）**：\n```typescript\nexport function requireRole(...roles: string[]) {\n  return (req: Request, res: Response, next: NextFunction) => {\n    if (!req.user || !roles.includes(req.user.role)) {\n      return res.status(403).json({\n        success: false,\n        error: { code: 'FORBIDDEN', message: 'Insufficient permissions' },\n      });\n    }\n    next();\n  };\n}\n\n\u002F\u002F 使用\napp.delete('\u002Fapi\u002Fusers\u002F:id', authMiddleware, requireRole('admin'), deleteUser);\n```\n\n### 输入消毒\n\n- **SQL 注入防护**：使用参数化查询或 ORM\n- **XSS 防护**：转义用户输入，使用 Content Security Policy\n- **CSRF 防护**：使用 CSRF Token\n- **文件上传**：验证文件类型和大小\n\n### 速率限制\n\n```typescript\nimport rateLimit from 'express-rate-limit';\n\nconst limiter = rateLimit({\n  windowMs: 15 * 60 * 1000, \u002F\u002F 15 分钟\n  max: 100, \u002F\u002F 最多 100 个请求\n  message: 'Too many requests, please try again later',\n});\n\napp.use('\u002Fapi\u002F', limiter);\n```\n\n## 分层架构\n\n### Controller 层\n\n职责：处理 HTTP 请求和响应\n```typescript\n\u002F\u002F controllers\u002FuserController.ts\nexport class UserController {\n  async getUser(req: Request, res: Response) {\n    try {\n      const user = await userService.getById(req.params.id);\n      res.json({ success: true, data: user });\n    } catch (error) {\n      next(error);\n    }\n  }\n\n  async createUser(req: Request, res: Response) {\n    const validatedData = CreateUserSchema.parse(req.body);\n    const user = await userService.create(validatedData);\n    res.status(201).json({ success: true, data: user });\n  }\n}\n```\n\n### Service 层\n\n职责：业务逻辑封装\n```typescript\n\u002F\u002F services\u002FuserService.ts\nexport class UserService {\n  async getById(id: string): Promise\u003CUser> {\n    const user = await userRepository.findById(id);\n    if (!user) {\n      throw new NotFoundError('User not found');\n    }\n    return user;\n  }\n\n  async create(data: CreateUserDto): Promise\u003CUser> {\n    \u002F\u002F 检查邮箱唯一性\n    const existing = await userRepository.findByEmail(data.email);\n    if (existing) {\n      throw new ConflictError('Email already exists');\n    }\n\n    \u002F\u002F 创建用户\n    return userRepository.create(data);\n  }\n}\n```\n\n### Repository 层\n\n职责：数据库操作\n```typescript\n\u002F\u002F repositories\u002FuserRepository.ts\nexport class UserRepository {\n  async findById(id: string): Promise\u003CUser | null> {\n    return db.user.findUnique({ where: { id } });\n  }\n\n  async findByEmail(email: string): Promise\u003CUser | null> {\n    return db.user.findUnique({ where: { email } });\n  }\n\n  async create(data: CreateUserDto): Promise\u003CUser> {\n    return db.user.create({ data });\n  }\n}\n```\n\n## 日志记录\n\n### 日志级别\n\n| 级别  | 使用场景                     |\n| ----- | ---------------------------- |\n| ERROR | 错误和异常                   |\n| WARN  | 警告信息                     |\n| INFO  | 关键操作（登录、创建、删除） |\n| DEBUG | 调试信息                     |\n\n### 日志示例\n\n```typescript\nimport winston from 'winston';\n\nconst logger = winston.createLogger({\n  level: 'info',\n  format: winston.format.json(),\n  transports: [\n    new winston.transports.File({ filename: 'error.log', level: 'error' }),\n    new winston.transports.File({ filename: 'combined.log' }),\n  ],\n});\n\n\u002F\u002F 使用\nlogger.info('User created', { userId: user.id, email: user.email });\nlogger.error('Database connection failed', { error: err.message });\n```\n\n## 性能优化\n\n### 数据库查询优化\n\n- 使用索引加速查询\n- 避免 N+1 查询问题\n- 使用连接（JOIN）代替多次查询\n- 分页查询大数据集\n\n### 缓存策略\n\n```typescript\nimport Redis from 'ioredis';\n\nconst redis = new Redis();\n\nasync function getUserWithCache(id: string): Promise\u003CUser> {\n  \u002F\u002F 尝试从缓存获取\n  const cached = await redis.get(`user:${id}`);\n  if (cached) {\n    return JSON.parse(cached);\n  }\n\n  \u002F\u002F 从数据库获取\n  const user = await userRepository.findById(id);\n\n  \u002F\u002F 写入缓存（5 分钟过期）\n  await redis.setex(`user:${id}`, 300, JSON.stringify(user));\n\n  return user;\n}\n```\n\n### 连接池管理\n\n- 配置合理的数据库连接池大小\n- 及时释放连接\n- 监控连接池使用情况\n\n## 实现检查清单\n\n实现 API 前：\n- [ ] 阅读 architecture.md §5 API 设计\n- [ ] 确认请求\u002F响应格式约定\n- [ ] 确认认证和授权方案\n- [ ] 探索项目现有代码模式\n\n实现 API 后：\n- [ ] API 端点符合契约定义\n- [ ] 实现请求验证\n- [ ] 实现统一错误处理\n- [ ] 添加认证和授权\n- [ ] TDD：每个 Service\u002FController 先有失败测试，已验证 RED\n- [ ] 编写单元测试（Service 层）\n- [ ] 编写集成测试（API 端点）\n- [ ] 编写 E2E 测试（完整流程）\n- [ ] 添加日志记录\n- [ ] 代码通过 Lint 检查\n","# 后端 API 开发方法论\n\n## API 契约管理\n\n### 契约来源\n\n实现 API 前，**必须**阅读 `architecture.md` §5（API 设计），获取：\n- API 规范（RESTful\u002FGraphQL）\n- 接口列表（方法、路径、描述、认证要求）\n- 请求\u002F响应格式约定\n- 错误码规范\n\n### 契约遵守原则\n\n1. **严格实现**：API 端点的方法、路径、参数必须与 architecture.md §5 一致\n2. **响应格式**：遵循统一的成功\u002F错误响应结构\n3. **偏差记录**：如需偏离契约，必须在输出报告中标注原因\n4. **类型导出**：将请求\u002F响应类型导出到共享文件，供前端引用\n\n## RESTful API 设计\n\n### 资源命名规范\n\n| 操作 | HTTP 方法 | 路径             | 说明         |\n| ---- | --------- | ---------------- | ------------ |\n| 列表 | GET       | `\u002Fapi\u002Fusers`     | 获取用户列表 |\n| 详情 | GET       | `\u002Fapi\u002Fusers\u002F:id` | 获取单个用户 |\n| 创建 | POST      | `\u002Fapi\u002Fusers`     | 创建新用户   |\n| 更新 | PUT\u002FPATCH | `\u002Fapi\u002Fusers\u002F:id` | 更新用户     |\n| 删除 | DELETE    | `\u002Fapi\u002Fusers\u002F:id` | 删除用户     |\n\n### 统一响应格式\n\n**成功响应**：\n```json\n{\n  \"success\": true,\n  \"data\": { ... },\n  \"message\": \"Operation successful\"\n}\n```\n\n**错误响应**：\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"VALIDATION_ERROR\",\n    \"message\": \"Invalid input data\",\n    \"details\": [{ \"field\": \"email\", \"message\": \"Invalid email format\" }]\n  }\n}\n```\n\n### 分页规范\n\n**请求参数**：\n```\nGET \u002Fapi\u002Fusers?page=1&pageSize=20&sortBy=createdAt&order=desc\n```\n\n**响应格式**：\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"items\": [...],\n    \"pagination\": {\n      \"page\": 1,\n      \"pageSize\": 20,\n      \"total\": 100,\n      \"totalPages\": 5\n    }\n  }\n}\n```\n\n## 请求验证\n\n### 输入验证层级\n\n1. **路由层**：验证路径参数和查询参数\n2. **中间件层**：验证请求体格式和必填字段\n3. **Service 层**：验证业务规则\n\n### 验证示例\n\n```typescript\n\u002F\u002F 使用验证库（如 Zod、Joi、class-validator）\nimport { z } from 'zod';\n\nconst CreateUserSchema = z.object({\n  name: z.string().min(1).max(100),\n  email: z.string().email(),\n  age: z.number().int().min(0).max(150).optional(),\n});\n\n\u002F\u002F 在路由处理器中验证\napp.post('\u002Fapi\u002Fusers', async (req, res) => {\n  try {\n    const validatedData = CreateUserSchema.parse(req.body);\n    const user = await userService.create(validatedData);\n    res.json({ success: true, data: user });\n  } catch (error) {\n    if (error instanceof z.ZodError) {\n      res.status(400).json({\n        success: false,\n        error: {\n          code: 'VALIDATION_ERROR',\n          message: 'Invalid input data',\n          details: error.errors,\n        },\n      });\n    }\n  }\n});\n```\n\n### 常见验证规则\n\n- **必填字段**：确保关键字段存在\n- **类型检查**：字符串、数字、布尔值、日期\n- **格式验证**：邮箱、URL、手机号、UUID\n- **范围限制**：最小\u002F最大长度、数值范围\n- **业务规则**：唯一性、外键存在性\n\n## 错误处理\n\n### 错误分类\n\n| 错误类型   | HTTP 状态码 | 错误码           | 说明                   |\n| ---------- | ----------- | ---------------- | ---------------------- |\n| 验证错误   | 400         | VALIDATION_ERROR | 输入数据不合法         |\n| 认证错误   | 401         | UNAUTHORIZED     | 未登录或 Token 无效    |\n| 权限错误   | 403         | FORBIDDEN        | 无权限访问资源         |\n| 资源不存在 | 404         | NOT_FOUND        | 请求的资源不存在       |\n| 冲突错误   | 409         | CONFLICT         | 资源冲突（如重复创建） |\n| 服务器错误 | 500         | INTERNAL_ERROR   | 服务器内部错误         |\n\n### 统一错误处理中间件\n\n```typescript\n\u002F\u002F errorHandler.ts\nexport function errorHandler(err: Error, req: Request, res: Response, next: NextFunction) {\n  console.error(err);\n\n  if (err instanceof ValidationError) {\n    return res.status(400).json({\n      success: false,\n      error: {\n        code: 'VALIDATION_ERROR',\n        message: err.message,\n        details: err.details,\n      },\n    });\n  }\n\n  if (err instanceof NotFoundError) {\n    return res.status(404).json({\n      success: false,\n      error: {\n        code: 'NOT_FOUND',\n        message: err.message,\n      },\n    });\n  }\n\n  \u002F\u002F 默认 500 错误\n  res.status(500).json({\n    success: false,\n    error: {\n      code: 'INTERNAL_ERROR',\n      message: 'An unexpected error occurred',\n    },\n  });\n}\n```\n\n## 安全实现\n\n### 认证（Authentication）\n\n**JWT Token 示例**：\n```typescript\nimport jwt from 'jsonwebtoken';\n\n\u002F\u002F 生成 Token\nexport function generateToken(userId: string): string {\n  return jwt.sign({ userId }, process.env.JWT_SECRET!, {\n    expiresIn: '7d',\n  });\n}\n\n\u002F\u002F 验证 Token 中间件\nexport function authMiddleware(req: Request, res: Response, next: NextFunction) {\n  const token = req.headers.authorization?.replace('Bearer ', '');\n\n  if (!token) {\n    return res.status(401).json({\n      success: false,\n      error: { code: 'UNAUTHORIZED', message: 'No token provided' },\n    });\n  }\n\n  try {\n    const decoded = jwt.verify(token, process.env.JWT_SECRET!);\n    req.user = decoded;\n    next();\n  } catch (error) {\n    res.status(401).json({\n      success: false,\n      error: { code: 'UNAUTHORIZED', message: 'Invalid token' },\n    });\n  }\n}\n```\n\n### 授权（Authorization）\n\n**基于角色的访问控制（RBAC）**：\n```typescript\nexport function requireRole(...roles: string[]) {\n  return (req: Request, res: Response, next: NextFunction) => {\n    if (!req.user || !roles.includes(req.user.role)) {\n      return res.status(403).json({\n        success: false,\n        error: { code: 'FORBIDDEN', message: 'Insufficient permissions' },\n      });\n    }\n    next();\n  };\n}\n\n\u002F\u002F 使用\napp.delete('\u002Fapi\u002Fusers\u002F:id', authMiddleware, requireRole('admin'), deleteUser);\n```\n\n### 输入消毒\n\n- **SQL 注入防护**：使用参数化查询或 ORM\n- **XSS 防护**：转义用户输入，使用 Content Security Policy\n- **CSRF 防护**：使用 CSRF Token\n- **文件上传**：验证文件类型和大小\n\n### 速率限制\n\n```typescript\nimport rateLimit from 'express-rate-limit';\n\nconst limiter = rateLimit({\n  windowMs: 15 * 60 * 1000, \u002F\u002F 15 分钟\n  max: 100, \u002F\u002F 最多 100 个请求\n  message: 'Too many requests, please try again later',\n});\n\napp.use('\u002Fapi\u002F', limiter);\n```\n\n## 分层架构\n\n### Controller 层\n\n职责：处理 HTTP 请求和响应\n```typescript\n\u002F\u002F controllers\u002FuserController.ts\nexport class UserController {\n  async getUser(req: Request, res: Response) {\n    try {\n      const user = await userService.getById(req.params.id);\n      res.json({ success: true, data: user });\n    } catch (error) {\n      next(error);\n    }\n  }\n\n  async createUser(req: Request, res: Response) {\n    const validatedData = CreateUserSchema.parse(req.body);\n    const user = await userService.create(validatedData);\n    res.status(201).json({ success: true, data: user });\n  }\n}\n```\n\n### Service 层\n\n职责：业务逻辑封装\n```typescript\n\u002F\u002F services\u002FuserService.ts\nexport class UserService {\n  async getById(id: string): Promise\u003CUser> {\n    const user = await userRepository.findById(id);\n    if (!user) {\n      throw new NotFoundError('User not found');\n    }\n    return user;\n  }\n\n  async create(data: CreateUserDto): Promise\u003CUser> {\n    \u002F\u002F 检查邮箱唯一性\n    const existing = await userRepository.findByEmail(data.email);\n    if (existing) {\n      throw new ConflictError('Email already exists');\n    }\n\n    \u002F\u002F 创建用户\n    return userRepository.create(data);\n  }\n}\n```\n\n### Repository 层\n\n职责：数据库操作\n```typescript\n\u002F\u002F repositories\u002FuserRepository.ts\nexport class UserRepository {\n  async findById(id: string): Promise\u003CUser | null> {\n    return db.user.findUnique({ where: { id } });\n  }\n\n  async findByEmail(email: string): Promise\u003CUser | null> {\n    return db.user.findUnique({ where: { email } });\n  }\n\n  async create(data: CreateUserDto): Promise\u003CUser> {\n    return db.user.create({ data });\n  }\n}\n```\n\n## 日志记录\n\n### 日志级别\n\n| 级别  | 使用场景                     |\n| ----- | ---------------------------- |\n| ERROR | 错误和异常                   |\n| WARN  | 警告信息                     |\n| INFO  | 关键操作（登录、创建、删除） |\n| DEBUG | 调试信息                     |\n\n### 日志示例\n\n```typescript\nimport winston from 'winston';\n\nconst logger = winston.createLogger({\n  level: 'info',\n  format: winston.format.json(),\n  transports: [\n    new winston.transports.File({ filename: 'error.log', level: 'error' }),\n    new winston.transports.File({ filename: 'combined.log' }),\n  ],\n});\n\n\u002F\u002F 使用\nlogger.info('User created', { userId: user.id, email: user.email });\nlogger.error('Database connection failed', { error: err.message });\n```\n\n## 性能优化\n\n### 数据库查询优化\n\n- 使用索引加速查询\n- 避免 N+1 查询问题\n- 使用连接（JOIN）代替多次查询\n- 分页查询大数据集\n\n### 缓存策略\n\n```typescript\nimport Redis from 'ioredis';\n\nconst redis = new Redis();\n\nasync function getUserWithCache(id: string): Promise\u003CUser> {\n  \u002F\u002F 尝试从缓存获取\n  const cached = await redis.get(`user:${id}`);\n  if (cached) {\n    return JSON.parse(cached);\n  }\n\n  \u002F\u002F 从数据库获取\n  const user = await userRepository.findById(id);\n\n  \u002F\u002F 写入缓存（5 分钟过期）\n  await redis.setex(`user:${id}`, 300, JSON.stringify(user));\n\n  return user;\n}\n```\n\n### 连接池管理\n\n- 配置合理的数据库连接池大小\n- 及时释放连接\n- 监控连接池使用情况\n\n## 实现检查清单\n\n实现 API 前：\n- [ ] 阅读 architecture.md §5 API 设计\n- [ ] 确认请求\u002F响应格式约定\n- [ ] 确认认证和授权方案\n- [ ] 探索项目现有代码模式\n\n实现 API 后：\n- [ ] API 端点符合契约定义\n- [ ] 实现请求验证\n- [ ] 实现统一错误处理\n- [ ] 添加认证和授权\n- [ ] TDD：每个 Service\u002FController 先有失败测试，已验证 RED\n- [ ] 编写单元测试（Service 层）\n- [ ] 编写集成测试（API 端点）\n- [ ] 编写 E2E 测试（完整流程）\n- [ ] 添加日志记录\n- [ ] 代码通过 Lint 检查\n",{"name":5,"type":39,"agent":48,"internal":49,"metadata":6,"description":7},"boss-backend",true,"main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002FechoVic\u002Fboss-skill\u002Fskill\u002Fskills\u002Fbackend\u002Fapi-development",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":61,"prompt":71,"zipAvailable":49},[62,65,68],{"tool":63,"command":64},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill backend\u002Fapi-development",{"tool":66,"command":67},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill backend\u002Fapi-development",{"tool":69,"command":70},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill backend\u002Fapi-development","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002FechoVic\u002Fboss-skill\u002Fskill\u002Fskills\u002Fbackend\u002Fapi-development\u002FSKILL.md",[],[74,84,92,100,108,116],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":79,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":83},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":88,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":83},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":96,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":83},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":104,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":83},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":112,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":83},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":78,"licenseFileUrl":120,"sourceHtmlUrl":121,"categories":122,"keywords":123,"publishedAt":83},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]