SuperAPI AI 工具集

backend-dev-guidelines

编程与开发

查看项目

更新于 10-16 05:48

技能介绍

用途:为 Node.js/Express/TypeScript 微服务提供一致的开发规范与最佳实践,在创建或修改路由、端点、API,构建控制器、服务、仓储,实现认证/校验/错误处理中间件,使用 Prisma 操作数据库,接入 Sentry 与 Zod,管理配置以及进行后端测试与重构时自动启用。

主要能力:约定分层架构——请求经 Routes(仅路由)、Controllers(请求处理)、Services(业务逻辑)、Repositories(数据访问)到 Prisma 数据库,每层单一职责;规定命名约定(控制器 PascalCase、服务 camelCase、路由 camelCase+Routes、仓储 PascalCase+Repository)与目录结构;给出新建后端功能与新建微服务的检查清单;列出七条核心规则:路由只做路由、控制器继承 BaseController、所有错误上报 Sentry、使用 unifiedConfig 而非 process.env、Zod 校验全部输入、仓储模式访问数据、必须编写完整测试;并提供 HTTP 状态码与常用导入速查及反模式提示。

使用方式:作为技能自动激活,按其检查清单与规则编写代码;新建微服务需配置目录结构、Sentry 的 instrument.ts、unifiedConfig、BaseController、中间件栈、错误边界与测试框架。技能内含 11 个资源文件,按需查阅:architecture-overview、routing-and-controllers、services-and-repositories、validation-patterns、sentry-and-monitoring、middleware-guide、database-patterns、configuration、async-and-errors、testing-guide、complete-examples。相关技能有 database-verification、error-tracking、skill-developer。

适用场景:Node.js/Express/TypeScript 微服务的日常开发、规范落地、代码审查与重构,尤其是使用 Prisma、Zod、Sentry 的项目。

限制:资料未提供具体安装命令、版本要求、收费方式或运行环境依赖,暂未提供。