用途:该技能面向 Node.js/TypeScript 后端开发,用于构建 REST 与 GraphQL API,由 executor agent 在检测到 Node.js 项目时加载。检测依据包括存在 package.json、server.ts 或 index.ts 或 src/server.ts,以及 express、fastify、@prisma/client 等依赖。
主要能力:支持 Node.js 18+ 与 Bun 运行时,TypeScript 严格模式,Express、Fastify、Hono 框架,Prisma ORM 数据库访问,Zod 输入校验,Vitest 与 Jest 测试。技能规定项目结构(config、routes、services、middleware、types、lib、server.ts、prisma/schema.prisma),要求集中式配置(单一 env.ts,启动时用 Zod 校验,配置无效立即崩溃),Prisma 客户端单例模式,路由轻量化、业务逻辑放入 service 单例,统一错误处理中间件(区分 ZodError、Prisma 错误码 P2002/P2025、自定义 AppError),以及 Zod 校验中间件。
使用方式:按约定创建目录与文件,在 routes 中定义 Zod schema 并调用 service,service 使用 Prisma 访问数据库,错误通过 try/catch 与 next(error) 交给错误中间件;server.ts 中启用 helmet、cors、express.json,注册 /health 与 /api 路由,错误处理中间件必须最后注册,并处理 SIGTERM 优雅关闭。命名约定为变量函数 camelCase、类与类型 PascalCase、文件 kebab-case、常量 SCREAMING_SNAKE_CASE。
适用场景:Node.js/TypeScript 后端 API 开发,尤其是需要严格类型、统一校验与错误处理、Prisma 数据访问的项目。
限制:资料未提供安装命令、版本依赖清单、收费与价格信息、性能数据或平台支持范围;具体实现需结合项目实际情况调整。