Навыки backend-dev-guidelines
📦

backend-dev-guidelines

Безопасно

Создавайте production-бэкенды на Node.js с лучшими практиками

Также доступно от: BrianDai22,diet103,Dimon94,DojoCodingLabs

Хватит гадать с архитектурой бэкенда. Получите комплексные рекомендации для слоистых сервисов Node.js с Express, TypeScript, репозиториями Prisma и валидацией Zod, которые надежно масштабируются.

Поддерживает: Claude Codex Code(CC)
📊 71 Адекватно
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «backend-dev-guidelines». Create a user registration endpoint

Ожидаемый результат:

  • Сгенерирована схема валидации Zod для пользовательского ввода
  • Создан UserController, расширяющий BaseController, с методом createUser
  • Реализован UserService с бизнес-логикой и внедрением зависимостей
  • Создан UserRepository с запросами Prisma
  • Добавлена регистрация маршрута с asyncErrorWrapper
  • Включены отслеживание ошибок Sentry и оценка BFRI

Использование «backend-dev-guidelines». Refactor inline database queries in routes

Ожидаемый результат:

  • Вынесена бизнес-логика из маршрутов в новый UserService
  • Создан UserRepository для инкапсуляции операций Prisma
  • Обновлен UserController для оркестрации вызовов сервиса
  • Добавлены корректные границы ошибок через BaseController
  • Написаны unit-тесты для слоя сервиса
  • BFRI улучшен с -2 (опасно) до 8 (безопасно)

Аудит безопасности

Безопасно
v1 • 2/25/2026

Static analysis flagged 544 patterns across 12 markdown documentation files (5337 lines). All findings are FALSE POSITIVES - the detected patterns exist in markdown code examples and documentation, not executable code. This skill provides secure backend development guidelines that explicitly teach against risky patterns like direct process.env usage. Safe for publication.

12
Просканировано файлов
5,337
Проанализировано строк
0
находки
1
Всего аудитов
Проблем безопасности не найдено
Проверено: claude

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
31
Сообщество
100
Безопасность
91
Соответствие спецификации

Что вы можете построить

Разработка нового микросервиса

Сгенерируйте полноценный бэкенд-микросервис с нуля по production-паттернам с правильной слоистостью, валидацией и обработкой ошибок.

Рефакторинг легаси-кода

Перепишите монолитные обработчики маршрутов в корректную слоистую архитектуру с контроллерами, сервисами и репозиториями для улучшения сопровождаемости.

Онбординг команды и стандарты

Установите единые стандарты разработки бэкенда между командами с четкими паттернами архитектуры, тестирования и обработки ошибок.

Попробуйте эти промпты

Создать новый контроллер 
Create a UserController following the BaseController pattern with methods for getUser, listUsers, createUser, and updateUser. Include proper error handling with Sentry integration.
Реализовать слой сервиса с DI 
Create a UserService that receives UserRepository via dependency injection. Include methods for findById, getAll, create, update, and delete with proper business logic separation.
Собрать полноценную фичу с валидацией 
Implement a complete user registration feature with Zod validation schema, controller extending BaseController, service with business logic, and repository with Prisma. Include BFRI scoring for the implementation.
Рефакторинг легаси-кода в слоистую архитектуру 
Refactor this monolithic route handler into proper layered architecture. Identify routes, controllers, services, and repositories. Add proper error handling, validation, and Sentry tracking. Calculate BFRI before and after.

Лучшие практики

  • Всегда используйте слоистую архитектуру: routes делегируют контроллерам, контроллеры вызывают сервисы, сервисы используют репозитории
  • Никогда не используйте process.env напрямую — доступайте к конфигурации через unifiedConfig для типобезопасности и тестируемости
  • Валидируйте весь внешний ввод схемами Zod до обработки — тела запросов, query params и route params

Избегать

  • Бизнес-логика в обработчиках маршрутов — маршруты должны только делегировать контроллерам
  • Прямое использование Prisma в контроллерах — всегда абстрагируйте через репозитории
  • Использование console.log для ошибок — все ошибки должны попадать в Sentry

Часто задаваемые вопросы

Почему использовать слоистую архитектуру вместо логики в маршрутах?
Слоистая архитектура обеспечивает тестируемость, переиспользуемость и сопровождаемость. Сервисы можно тестировать независимо, переиспользовать между маршрутами/cron jobs/scripts, а баги легче находить в изолированных слоях.
Что такое BFRI и как его рассчитать?
BFRI (Backend Feasibility Risk Index) = (Architectural Fit + Testability) - (Complexity + Data Risk + Operational Risk). Диапазон баллов от -10 до +10. Значения выше 3 безопасны для продолжения; ниже 0 требуют переработки.
Почему нельзя использовать process.env напрямую в коде?
Прямое использование process.env лишено типобезопасности и валидации и усложняет тестирование. unifiedConfig предоставляет типизированный доступ с значениями по умолчанию, валидирует при старте и упрощает мокинг в тестах.
Нужно ли расширять BaseController для всех контроллеров?
Да. BaseController обеспечивает единообразную обработку ошибок через handleError, успешные ответы через handleSuccess, интеграцию Sentry и трассировку запросов. Это гарантирует одинаковое поведение всех эндпоинтов.
Когда следует использовать транзакции в сервисах?
Используйте транзакции, когда несколько операций базы данных должны завершиться успешно или быть полностью откатаны. Оборачивайте связанные операции в this.withTransaction() для атомарности и корректного rollback при ошибках.
Как тестировать сервисы, использующие внедрение зависимостей?
В тестах внедряйте mock-репозитории через конструктор сервиса. Это позволяет тестировать бизнес-логику изолированно без доступа к базе. Подойдут Jest mocks или ручные mock-классы для этого паттерна.

Сведения для разработчиков

Автор

sickn33

Лицензия

MIT

Репозиторий

https://github.com/sickn33/antigravity-awesome-skills/tree/main/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