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

⚙️

backend-dev-guidelines

Name: backend-dev-guidelines
Author: BrianDai22

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

Construa serviços backend Node.js com melhores práticas

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

Código backend inconsistente causa bugs e desenvolvimento lento. Esta skill fornece padrões de arquitetura em camadas, templates BaseController, padrões de repositório Prisma, guias de validação Zod e integração Sentry para microsserviços Express confiáveis.

يدعم: Claude Codex Code(CC)

📊 69 كافٍ

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

رفع في Claude

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

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

اختبرها

استخدام "backend-dev-guidelines". Crie uma rota para criar um novo usuário

النتيجة المتوقعة:

Definição de rota (routes/userRoutes.ts):
- Define rota POST /users
- Aplica SSOMiddlewareClient.verifyLoginStatus
- Delega para UserController.createUser
Método do controller (controllers/UserController.ts):
- Estende BaseController
- Valida entrada com createUserSchema.parse(req.body)
- Chama userService.create(validated)
- Usa handleSuccess com status 201 em caso de sucesso
- Usa handleError com captura Sentry em caso de falha

استخدام "backend-dev-guidelines". Adicione validação a um endpoint de API existente

النتيجة المتوقعة:

Crie um schema Zod em validators/userSchemas.ts:
- Define formato de entrada com inferência de tipo
- Adiciona restrições de string (formato de email, comprimento mínimo)
- Exporta tipo inferido para uso em TypeScript
Atualize o controller:
- Importe e use schema.parse(req.body)
- Trate ZodError com mensagens formatadas
- Retorne 400 em falha de validação

التدقيق الأمني

آمن

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

الأمان

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

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

Novo endpoint Express

Crie uma rota limpa que delega para um controller seguindo o padrão de arquitetura em camadas

Adicionar validação de entrada

Implemente validação type-safe com schemas Zod e inferência automática de tipos TypeScript

Padrões de code review

Imponha padrões consistentes entre microsserviços com BaseController e padrões de repository

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

Novo endpoint

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

Schema de validação

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

Padrão repository

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

Tratamento de erros

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

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

Mantenha as rotas limpas delegando toda a lógica para controllers
Estenda BaseController para tratamento de erros consistente e integração Sentry
Use Zod para validação de entrada type-safe com inferência automática de TypeScript
Separe responsabilidades: rotas lidam com roteamento, controllers lidam com HTTP, services lidam com lógica de negócio, repositories lidam com acesso a dados

تجنب

Lógica de negócio em route handlers - viola separação de responsabilidades
Uso direto de process.env em vez de unifiedConfig
Falta de tratamento de erros ou supressão de erros sem captura Sentry
Chamadas diretas ao Prisma em controllers ou services - use repositories em vez disso

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

Esta skill funciona com Fastify em vez de Express?

Os padrões se traduzem para Fastify com pequenos ajustes. Rotas e controllers permanecem similares. Use o sistema de plugins do Fastify em vez disso.

Quais ORMs de banco de dados são suportados?

O padrão primário usa Prisma, mas o padrão repository se aplica a qualquer ORM. Kysely e TypeORM podem usar camadas de service e repository similares.

Posso usar isso com rotas de API do Next.js?

Sim. O padrão de controller mapeia para handlers de rota de API. Services e repositories funcionam inalterados. Adapte BaseController para Next.js Response.

Meus dados estão seguros ao usar esta skill?

Sim. Esta é uma skill apenas de documentação. Ela fornece exemplos de código mas nunca acessa seus arquivos, variáveis de ambiente ou faz requisições de rede.

Por que estou recebendo erros de tipo com o código gerado?

Certifique-se de ter as dependências necessárias instaladas: @sentry/node, @prisma/client, zod e seus tipos TypeScript. Execute prisma generate após definir o schema.

Como isso é diferente de sites de documentação?

Esta skill fornece padrões context-aware específicos para sua base de código. Ela entende seus padrões existentes e gera código consistente com sua arquitetura.