backend-dev-guidelines
Применение лучших практик backend-разработки
متاح أيضًا من: Dimon94,BrianDai22,DojoCodingLabs,sickn33
Создавайте согласованные, поддерживаемые backend-сервисы с проверенными паттернами Node.js/Express/TypeScript. Этот навык предоставляет архитектурное руководство, шаблоны кода и безопасные паттерны для разработки микросервисов.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "backend-dev-guidelines". Create a POST /posts endpoint with authentication
النتيجة المتوقعة:
- Полное определение маршрута с SSO middleware
- BaseController с отслеживанием breadcrumb
- PostService с внедрением зависимостей
- PostRepository с запросами Prisma
- Схема валидации Zod для данных поста
- Обработка ошибок с захватом Sentry
استخدام "backend-dev-guidelines". Convert legacy callback code to async/await
النتيجة المتوقعة:
- Обновленные методы сервиса с try/catch
- Использование утилиты AsyncErrorWrapper
- Интеграция захвата ошибок Sentry
- Promise.all() для параллельных операций
- Правильное распространение ошибок в контроллер
استخدام "backend-dev-guidelines". Add input validation to existing endpoint
النتيجة المتوقعة:
- Определение схемы Zod с выводом типов
- Валидация в контроллере перед вызовом сервиса
- Статус-код 400 при ошибке валидации
- Детали ошибки в ответе
- Тестовые случаи для невалидных входных данных
التدقيق الأمني
آمنAll 555 static findings are FALSE POSITIVES. This is a documentation/guide skill containing educational code examples. The detected patterns (shell commands, environment variables, path traversal, crypto algorithms) are in markdown code blocks demonstrating best practices and anti-patterns. The skill actively promotes secure coding - it teaches AGAINST vulnerabilities like path traversal and weak cryptography, not exploits them.
عوامل الخطر
⚙️ الأوامر الخارجية (2)
🔑 متغيرات البيئة (2)
📁 الوصول إلى نظام الملفات (2)
درجة الجودة
ماذا يمكنك بناءه
Реализация новой функциональности
Генерация кода контроллера, сервиса и репозитория в соответствии с архитектурными паттернами для новых API-эндпоинтов.
Стандартизация кодовой базы
Установление единообразных паттернов в нескольких микросервисах с использованием BaseController и unifiedConfig.
Разработка Express API
Создание Express-маршрутов с правильными middleware, валидацией и интеграцией отслеживания ошибок.
جرّب هذه الموجهات
Create a new /users/:id endpoint with UserController that extends BaseController, includes Zod validation, and proper error handling with Sentry.
Generate a UserService with dependency injection pattern, including repository calls and async error handling wrapper.
Create a UserRepository pattern with PrismaService usage, transaction support, and query optimization examples.
Generate complete feature with routes, BaseController, service with DI, repository layer, Zod validation schemas, and Jest tests.
أفضل الممارسات
- Используйте многослойную архитектуру: маршруты делегируют контроллерам, контроллеры вызывают сервисы, сервисы используют репозитории.
- Всегда наследуйте BaseController для единообразной обработки ошибок, breadcrumbs и интеграции Sentry.
- Валидируйте все входные данные с помощью схем Zod перед бизнес-логикой - отклоняйте невалидные данные на ранней стадии.
تجنب
- Никогда не размещайте бизнес-логику в обработчиках маршрутов - делегируйте контроллерам.
- Никогда не используйте process.env напрямую - используйте unifiedConfig для типобезопасности и тестирования.
- Никогда не пропускайте обработку ошибок - все асинхронные операции требуют try/catch с захватом Sentry.