技能 backend-dev-guidelines

⚙️

backend-dev-guidelines

Name: backend-dev-guidelines
Author: BrianDai22

安全 ⚙️ 外部命令🔑 环境变量📁 文件系统访问🌐 网络访问

使用最佳實踐構建 Node.js 後端服務

也可从以下获取: diet103,Dimon94,DojoCodingLabs,sickn33

不一致的後端代碼會導致錯誤和開發速度變慢。本技能提供分層架構模式、BaseController 模板、Prisma 倉庫模式、Zod 驗證指南以及 Sentry 集成，用於可靠的 Express 微服務。

支持: Claude Codex Code(CC)

📊 69 充足

下载技能 ZIP

在 Claude 中上传

前往设置 → 功能 → 技能 → 上传技能

开启并开始使用

测试它

正在使用“backend-dev-guidelines”。 Create a route for creating a new user

预期结果:

Route definition (routes/userRoutes.ts):
- Define POST /users route
- Apply SSOMiddlewareClient.verifyLoginStatus
- Delegate to UserController.createUser
Controller method (controllers/UserController.ts):
- Extend BaseController
- Validate input with createUserSchema.parse(req.body)
- Call userService.create(validated)
- Use handleSuccess with 201 status on success
- Use handleError with Sentry capture on failure

正在使用“backend-dev-guidelines”。 Add validation to an existing API endpoint

预期结果:

Create a Zod schema in validators/userSchemas.ts:
- Define input shape with type inference
- Add string constraints (email format, min length)
- Export inferred type for TypeScript usage
Update controller:
- Import and use schema.parse(req.body)
- Handle ZodError with formatted messages
- Return 400 on validation failure

安全审计

安全

v5 • 1/16/2026

Pure documentation skill containing only markdown files with TypeScript code examples. No executable code, no network calls, no file system access beyond reading its own files, and no environment variable access. Content matches stated purpose of providing backend development guidelines. All 556 static findings are false positives from misidentified template literals and anti-pattern documentation.

已扫描文件

5,538

分析行数

发现项

审计总数

风险因素

⚙️ 外部命令 (319)

🔑 环境变量 (53)

📁 文件系统访问 (44)

🌐 网络访问 (6)

resources/configuration.md:182 resources/configuration.md:186 resources/testing-guide.md:191 resources/testing-guide.md:194 skill-report.json:165 skill-report.json:6

审计者: claude 查看审计历史 →

质量评分

架构

100

可维护性

内容

社区

100

安全

规范符合性

你能构建什么

新的 Express 端點

創建一個遵循分層架構模式的乾淨路由，將邏輯委託給控制器

添加輸入驗證

使用 Zod 模式和自動 TypeScript 類型推斷實現類型安全的驗證

代碼審查標準

透過 BaseController 和倉庫模式在微服務中強制執行一致的代碼模式

试试这些提示

新端點

Create a route for /users that returns a list of active users. Use the layered architecture pattern with a controller that extends BaseController.

驗證模式

Create a Zod schema for a user registration form with email, name, and password fields. Include TypeScript type inference.

倉庫模式

Create a UserRepository class that uses PrismaService to find users by email and create new users. Include error handling.

錯誤處理

Show how to properly capture errors in a service method with Sentry, including user context and operation tags.

最佳实践

透過將所有邏輯委託給控制器來保持路由乾淨
擴展 BaseController 以實現一致的錯誤處理和 Sentry 集成
使用 Zod 實現類型安全的輸入驗證，帶有自動 TypeScript 推斷
關注點分離：路由處理路由、控制器處理 HTTP、服務處理業務邏輯、倉庫處理數據訪問

避免

業務邏輯在路由處理程序中 - 違反關注點分離原則
直接使用 process.env 而不是 unifiedConfig
缺少錯誤處理或在沒有 Sentry 捕獲的情況下吞掉錯誤
在控制器或服務中直接調用 Prisma - 應使用倉庫

常见问题

此技能可以與 Fastify 而不是 Express 一起使用嗎？

這些模式可以透過小幅調整應用於 Fastify。路由和控制器保持類似。使用 Fastify 插件系統替代。

支援哪些數據庫 ORM？

主要模式使用 Prisma，但倉庫模式適用於任何 ORM。Kysely 和 TypeORM 可以使用類似的服務和倉庫層。

我可以在 Next.js API 路由中使用此技能嗎？

可以。控制器模式映射到 API 路由處理程序。服務和倉庫保持不變。為 Next.js Response 適配 BaseController。

使用此技能時我的數據安全嗎？

可以。這是一個純文檔技能。它提供代碼示例，但從不存取您的文件、環境變量或發起網絡請求。

為什麼生成的代碼會出現類型錯誤？

確保您已安裝所需依賴項：@sentry/node、@prisma/client、zod 及其 TypeScript 類型。在定義模式後執行 prisma generate。

這與文檔網站有什麼不同？

此技能提供特定於您代碼庫的上下文感知模式。它了解您現有的模式並生成與您的架構一致的代碼。

开发者详情

作者

BrianDai22

许可证

MIT

仓库

https://github.com/BrianDai22/concetrateaiquiz/tree/main/.claude/skills/backend-dev-guidelines

引用

main

文件结构

📁 resources/

📄 architecture-overview.md

📄 async-and-errors.md

📄 complete-examples.md

📄 configuration.md

📄 database-patterns.md

📄 middleware-guide.md

📄 routing-and-controllers.md

📄 sentry-and-monitoring.md

📄 services-and-repositories.md

📄 testing-guide.md

📄 validation-patterns.md

📄 SKILL.md