用途:该技能为 Node.js、Express、TypeScript 微服务定义后端开发标准,以强制性规范而非建议的形式约束代码写法,目标是构建可预测、可观测、可维护的后端系统。
主要能力:要求采用 routes → controllers → services → repositories → database 的分层架构,禁止跨层调用;路由只负责转发,业务逻辑放在 service;控制器统一继承 BaseController 并由其处理响应与错误;所有错误上报 Sentry;配置统一从 unifiedConfig 读取;外部输入(请求体、查询参数、路由参数、Webhook)一律用 Zod 校验;服务通过构造函数注入依赖;Prisma 访问封装在 repository。另含 BFRI 可行性风险评分(架构契合度与可测试性减去复杂度、数据风险与运维风险),用于判断是否可直接实现、需补测试监控、需重构隔离或需重新设计。
使用方式:在涉及路由、控制器、服务、仓储、Express 中间件、Prisma、Zod、Sentry、配置管理或后端重构迁移时自动应用。规范给出目录结构、命名约定与 asyncErrorWrapper 包裹异步路由处理等要求,并列出禁止事项,如路由内写业务逻辑、跳过服务层、控制器直连 Prisma、缺少校验、直接使用 process.env、用 console.log 代替 Sentry、业务逻辑无测试。完成前需通过操作者校验清单,包括 BFRI ≥ 3、遵循分层、输入已校验、错误已捕获、使用 unifiedConfig、已编写测试、无禁止模式。
适用场景:面向有真实流量与风险、长期维护的 Node.js 微服务。
限制:资料未提供安装命令、运行平台、收费价格与具体效果数据;该技能与前端规范、错误追踪、数据库验证、分析追踪等其他技能存在集成关系,但具体集成细节暂未提供。