AIKraft/Skills/backend-dev-guidelines

backend-dev-guidelines

Настройка бэкенда для production-сервисов с учетом архитектурных ограничений. Применяется при работе с маршрутами, контроллерами, сервисами, репозиториями, middleware Express и доступом к базе данных через Prisma.

sickn33 official Разработка ★ 47.3k

Что делает навык

Настройка бэкенда для production-сервисов на Node.js, Express и TypeScript с соблюдением строгой архитектурной дисциплины. Skill обеспечивает предсказуемость, наблюдаемость и поддерживаемость систем через слоистую архитектуру, централизованную конфигурацию и обязательное тестирование.

Когда применять

  • Разработка новых маршрутов, контроллеров, сервисов и репозиториев в рамках микросервисной архитектуры.
  • Создание или модификация Express middleware и настройка доступа к базе данных через Prisma.
  • Проведение рефакторинга или миграции бэкенд-кода с целью устранения антипаттернов и улучшения тестируемости.
  • Настройка валидации входных данных с использованием Zod и интеграция отслеживания ошибок через Sentry.

Как работает

  1. Оценить BFRI (Backend Feasibility & Risk Index) для определения допустимости реализации и необходимости дополнительных тестов или мониторинга.
  2. Соблюдать обязательную слоистую архитектуру: Routes → Controllers → Services → Repositories → Database, без пропуска слоев.
  3. Использовать BaseController для обработки ошибок и форматирования ответов, а также asyncErrorWrapper для всех асинхронных обработчиков.
  4. Применять централизованную конфигурацию через unifiedConfig и валидировать все внешние входные данные с помощью Zod.
  5. Записывать все ошибки в Sentry, избегая console.log и молчаливых сбоев, и обеспечивать покрытие кода unit- и integration-тестами.

Примеры запросов агенту

Реализуй новый эндпоинт для создания пользователя, соблюдая архитектуру routes → controllers → services → repositories.
Проведи рефакторинг существующего контроллера: вынеси бизнес-логику в сервис, добавь валидацию Zod и обработку ошибок через Sentry.
Настрой структуру проекта src/ для нового микросервиса с учетом требований к именам файлов и директорий.

Что понадобится

  • Среда Node.js с использованием Express, TypeScript и Prisma.
  • Интеграция с Sentry для отслеживания ошибок и производительности.
  • Библиотека Zod для валидации входных данных.

Описание составлено по SKILL.md навыка, сверено 08.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «sickn33-backend-dev-guidelines» из репозитория: # https://github.com/sickn33/agentic-awesome-skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r sickn33-backend-dev-guidelines/ ~/.claude/skills/sickn33-backend-dev-guidelines/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.