用途:为 Node.js/Express/TypeScript 微服务建立一致的后端开发规范,基于 Prisma 与 Sentry,适用于创建或修改路由、端点与 API,构建控制器、服务与仓储,实现中间件(鉴权、校验、错误处理)、数据库操作、Sentry 错误追踪、Zod 输入校验、配置管理以及后端测试与重构。若技术栈不同,可参考架构原则并查看仓库根目录的 CLAUDE_INTEGRATION_GUIDE.md。
主要能力:采用分层架构,请求依次经过 Routes、Controllers、Services、Repositories 到达 Prisma 数据库,每层单一职责。七条核心规则包括:路由只负责路由、控制器负责控制;所有控制器继承 BaseController;所有错误上报 Sentry;使用 unifiedConfig 而非 process.env;用 Zod 校验所有输入;用仓储模式访问数据;要求全面测试。目录结构涵盖 config、controllers、services、repositories、routes、middleware、types、validators、utils、tests,以及 instrument.ts、app.ts、server.ts。命名约定:控制器用 PascalCase(UserController.ts),服务用 camelCase(userService.ts),路由用 camelCase + Routes(userRoutes.ts),仓储用 PascalCase + Repository(UserRepository.ts)。提供 11 个资源文件,按需查阅架构总览、路由与控制器、服务与仓储、校验模式、Sentry 与监控、中间件、数据库模式、配置、异步与错误、测试指南和完整示例。
使用方式:新建后端功能可按清单执行——路由清晰定义并委托控制器;控制器继承 BaseController;服务含业务逻辑与依赖注入;复杂时使用仓储;Zod 校验;Sentry 追踪;编写单元与集成测试;使用 unifiedConfig 配置。新建微服务需按架构概览建立目录、instrument.ts、unifiedConfig、BaseController、中间件栈、错误边界与测试框架。参考模板包括 Blog API(REST)与 Auth Service(鉴权)。
适用场景:Node.js/Express/TypeScript 微服务的日常开发与重构。
限制:面向上述特定技术栈,其他栈需自行适配。反模式包括路由中写业务逻辑、直接使用 process.env、缺少错误处理与输入校验、到处直接调用 Prisma、用 console.log 代替 Sentry。具体安装命令、收费与价格信息暂未提供。