المهارات backend-dev-guidelines

⚙️

backend-dev-guidelines

Name: backend-dev-guidelines
Author: BrianDai22

آمن ⚙️ الأوامر الخارجية🔑 متغيرات البيئة📁 الوصول إلى نظام الملفات🌐 الوصول إلى الشبكة

Construire des services backend Node.js avec les meilleures pratiques

متاح أيضًا من: DojoCodingLabs,diet103,Dimon94,sickn33

Un code backend incohérent provoque des bugs et ralentit le développement. Cette compétence fournit des patterns d’architecture en couches, des templates BaseController, des patterns de repository Prisma, des guides de validation Zod et une intégration Sentry pour des microservices Express fiables.

يدعم: Claude Codex Code(CC)

📊 69 كافٍ

تنزيل ZIP المهارة

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

فعّل وابدأ الاستخدام

اختبرها

استخدام "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

الأمان

الامتثال للمواصفات

ماذا يمكنك بناءه

Nouvel endpoint Express

Créer une route propre qui délègue à un contrôleur en suivant le pattern d’architecture en couches

Ajouter la validation des entrées

Implémenter une validation typée avec des schémas Zod et une inférence automatique des types TypeScript

Standards de revue de code

Appliquer des patterns cohérents entre microservices avec BaseController et des patterns de repository

جرّب هذه الموجهات

Nouvel endpoint

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

Schéma de validation

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

Pattern de repository

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

Gestion des erreurs

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

أفضل الممارسات

Gardez les routes propres en déléguant toute la logique aux contrôleurs
Étendez BaseController pour une gestion d’erreurs cohérente et l’intégration Sentry
Utilisez Zod pour une validation des entrées typée avec inférence automatique TypeScript
Séparez les responsabilités : les routes gèrent le routage, les contrôleurs gèrent HTTP, les services gèrent la logique métier, les repositories gèrent l’accès aux données

تجنب

Logique métier dans les handlers de routes - viole la séparation des responsabilités
Utilisation directe de process.env au lieu de unifiedConfig
Absence de gestion des erreurs ou erreurs ignorées sans capture Sentry
Appels Prisma directs dans les contrôleurs ou services - utilisez des repositories à la place

الأسئلة المتكررة

Cette compétence fonctionne-t-elle avec Fastify au lieu d’Express ?

Les patterns se transposent à Fastify avec de légers ajustements. Les routes et les contrôleurs restent similaires. Utilisez plutôt le système de plugins Fastify.

Quels ORM de base de données sont pris en charge ?

Le pattern principal utilise Prisma, mais le pattern de repository s’applique à n’importe quel ORM. Kysely et TypeORM peuvent utiliser des couches de services et de repositories similaires.

Puis-je l’utiliser avec les routes API Next.js ?

Oui. Le pattern de contrôleur correspond aux handlers des routes API. Les services et repositories fonctionnent sans changement. Adaptez BaseController pour Next.js Response.

Mes données sont-elles en sécurité lorsque j’utilise cette compétence ?

Oui. Cette compétence est uniquement documentaire. Elle fournit des exemples de code mais n’accède jamais à vos fichiers, variables d’environnement, ni ne fait de requêtes réseau.

Pourquoi ai-je des erreurs de type avec le code généré ?

Assurez-vous d’avoir les dépendances requises installées : @sentry/node, @prisma/client, zod, et leurs types TypeScript. Exécutez prisma generate après avoir défini le schéma.

En quoi est-ce différent des sites de documentation ?

Cette compétence fournit des patterns adaptés au contexte de votre codebase. Elle comprend vos patterns existants et génère un code cohérent avec votre architecture.