SuperAPI AI 工具集

backend-dev-guidelines

编程与开发

查看项目

更新于 10-16 09:28

技能介绍

用途:该技能面向运行生产级服务的高级后端工程师,在严格架构与可靠性约束下开发 Node.js、Express、TypeScript 微服务,强调分层架构、显式错误边界、强类型与校验、集中配置和一流的可观测性。适用于路由、控制器、服务、仓储层、Express 中间件、Prisma 数据访问、Zod 校验、Sentry 错误追踪、配置管理以及后端重构或迁移。

主要能力:定义强制架构规则(路由→控制器→服务→仓储→数据库,不得跳层);路由只做转发,控制器负责协调并继承 BaseController,业务规则放在服务层;控制器不得直接调用 Prisma;所有外部输入需用 Zod 校验;所有错误上报 Sentry,禁止 console.log 与静默失败;配置统一从 unifiedConfig 读取,禁止直接使用 process.env;异步路由处理器需用 asyncErrorWrapper 包装;服务通过构造函数依赖注入;要求服务单元测试、路由集成测试、复杂查询的仓储测试。

评估方式:提供后端可行性风险指数 BFRI,按架构契合度、可测试性、业务复杂度、数据风险、运维风险五个维度(1–5)计算,公式为 BFRI =(架构契合度 + 可测试性)−(复杂度 + 数据风险 + 运维风险),范围 -10 到 +10。6–10 可直接进行,3–5 需补充测试与监控,0–2 应重构或隔离,小于 0 须先重新设计再编码。

使用方式与限制:该技能以规范形式给出代码应如何编写,并列出目录结构、命名约定与反模式清单。资料未提供具体安装命令或配置步骤。其明确要求不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。