К основному содержанию
скилл CX Codex

service-layer-extractor — скилл для Claude Code: что делает

Скилл service-layer-extractor выносит бизнес-логику из контроллеров в сервисы и репозитории. Помогает навести порядок в раздутых роутах и подготовить код к юнит-тестам.

MIT 255 установок ★ 64 обновлён 2026-01-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add patricio0312rev/skills --skill service-layer-extractor -a claude-code
Открыть на GitHub

Что делает service-layer-extractor

Скилл раскладывает логику веб-приложения по слоям: роуты и контроллеры отвечают только за приём запросов и валидацию, сервисы берут оркестрацию задач, а репозитории работают с базой данных. В коде контроллеров больше не остаются прямые SQL-запросы или вызовы сторонних API вроде отправки писем.

Шаблон предлагает внедрение зависимостей через контейнер и пошаговый план миграции на восемь недель. Сначала создаются сервисные классы без ломки контрактов, затем пишутся мок-тесты на Jest, после чего SQL-запросы изолируются в репозитории. Разделение слоёв требует явных DTO-интерфейсов, иначе логика снова осядет внутри контроллера.

Какие задачи решает

  • Вынести SQL-запросы и сторонние API из обработчиков роутов в сервисы
  • Настроить внедрение зависимостей для тестирования логики без HTTP-запросов
  • Разбить кодовую базу на слои routes, controllers, services и repositories
  • Составить план поэтапного рефакторинга без нарушения работы API

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

  • Вынеси бизнес-логику из роута регистрации пользователей в отдельный сервис
  • Сделай репозиторий и сервис для контроллера заказов с внедрением зависимостей
  • Напиши юнит-тесты на Jest с моками для UserService

Как установить service-layer-extractor

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill service-layer-extractor -a claude-code

2Вручную: положить файлы

~/.claude/skills/service-layer-extractor/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/service-layer-extractor/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о service-layer-extractor

Как установить service-layer-extractor в Claude Code?

Выполните команду npx skills add patricio0312rev/skills --skill service-layer-extractor -a claude-code. Также файл скилла можно сохранить вручную по пути ~/.claude/skills/service-layer-extractor/SKILL.md.

Что делает скилл service-layer-extractor?

Он помогает разделить раздутые контроллеры на сервисы, репозитории и модели. Скилл задаёт структуру папок, примеры внедрения зависимостей и шаблон тестов.

Какие этапы включает план миграции архитектуры?

План рассчитан на четыре фазы: создание сервисных классов, покрытие тестами с целевым показателем от 80%, выделение репозиториев для базы данных и настройка DI-контейнера.

Исходный текст

SKILL.md · MIT
---
name: service-layer-extractor
description: Refactors route handlers into service layer with clean boundaries, dependency injection, testability, and separation of concerns. Provides service interfaces, folder structure, testing strategy, and migration plan. Use when refactoring "fat controllers", "business logic", "service layer", or "architecture cleanup".
---

# Service Layer Extractor

Extract business logic from controllers into a testable service layer.

## Architecture Layers

```
routes/          → Define endpoints, parse requests
controllers/     → Validate input, call services, format responses
services/        → Business logic, orchestration
repositories/    → Database queries
models/          → Data structures
```

## Before: Fat Controller

```typescript
// ❌ Business logic mixed with HTTP concerns
router.post("/users", async (req, res) => {
  try {
    // Validation
    if (!req.body.email) {
      return res.status(400).json({ error: "Email required" });
    }

    // Check duplicate
    const existing = await db.query("SELECT * FROM users WHERE email = $1", [
      req.body.email,
    ]);
    if (existing.rows.length > 0) {
      return res.status(409).json({ error: "Email already exists" });
    }

    // Hash password
    const hashedPassword = await bcrypt.hash(req.body.password, 10);

    // Create user
    const result = await db.query(
      "INSERT INTO users (email, password, name) VALUES ($1, $2, $3) RETURNING *",
      [req.body.email, hashedPassword, req.body.name]
    );

    // Send welcome email
    await sendEmail(req.body.email, "Welcome!", "Thanks for joining");

    res.status(201).json(result.rows[0]);
  } catch (err) {
    res.status(500).json({ error: err.message });
  }
});
```

## After: Service Layer

```typescript
// ✅ Separated concerns

// services/user.service.ts
export class UserService {
  constructor(
    private userRepository: UserRepository,
    private emailService: EmailService
  ) {}

  async createUser(dto: CreateUserDto): Promise<User> {
    // Business logic only
    const existing = await this.userRepository.findByEmail(dto.email);
    if (existing) {
      throw new ConflictError("Email already exists");
    }

    const hashedPassword = await bcrypt.hash(dto.password, 10);

    const user = await this.userRepository.create({
      ...dto,
      password: hashedPassword,
    });

    await this.emailService.sendWelcome(user.email);

    return user;
  }
}

// controllers/user.controller.ts
export class UserController {
  constructor(private userService: UserService) {}

  create = asyncHandler(async (req, res) => {
    const user = await this.userService.createUser(req.body);
    res.status(201).json({ success: true, data: user });
  });
}

// repositories/user.repository.ts
export class UserRepository {
  async create(data: CreateUserData): Promise<User> {
    const result = await db.query(
      "INSERT INTO users (email, password, name) VALUES ($1, $2, $3) RETURNING *",
      [data.email, data.password, data.name]
    );
    return result.rows[0];
  }

  async findByEmail(email: string): Promise<User | null> {
    const result = await db.query("SELECT * FROM users WHERE email = $1", [
      email,
    ]);
    return result.rows[0] || null;
  }
}
```

## Dependency Injection

```typescript
// container.ts (using tsyringe or manual)
import { UserService } from "./services/user.service";
import { UserRepository } from "./repositories/user.repository";
import { EmailService } from "./services/email.service";

export class Container {
  private static instances = new Map();

  static get<T>(constructor: new (...args: any[]) => T): T {
    if (!this.instances.has(constructor)) {
      // Create dependencies
      const deps = this.resolveDependencies(constructor);
      this.instances.set(constructor, new constructor(...deps));
    }
    return this.instances.get(constructor);
  }

  private static resolveDependencies(constructor: any): any[] {
    // Resolve constructor dependencies
    return [];
  }
}

// Usage
const userService = Container.get(UserService);
```

## Testing Services

```typescript
// user.service.test.ts
describe("UserService", () => {
  let service: UserService;
  let mockRepository: jest.Mocked<UserRepository>;
  let mockEmailService: jest.Mocked<EmailService>;

  beforeEach(() => {
    mockRepository = {
      create: jest.fn(),
      findByEmail: jest.fn(),
    } as any;

    mockEmailService = {
      sendWelcome: jest.fn(),
    } as any;

    service = new UserService(mockRepository, mockEmailService);
  });

  it("creates user successfully", async () => {
    mockRepository.findByEmail.mockResolvedValue(null);
    mockRepository.create.mockResolvedValue({
      id: "1",
      email: "[email protected]",
    });

    const user = await service.createUser({
      email: "[email protected]",
      password: "password123",
      name: "Test User",
    });

    expect(user.id).toBe("1");
    expect(mockEmailService.sendWelcome).toHaveBeenCalled();
  });

  it("throws error if email exists", async () => {
    mockRepository.findByEmail.mockResolvedValue({ id: "1" } as User);

    await expect(
      service.createUser({
        email: "[email protected]",
        password: "pass",
        name: "Test",
      })
    ).rejects.toThrow(ConflictError);
  });
});
```

## Folder Structure

```
src/
├── routes/
│   └── users.routes.ts
├── controllers/
│   └── user.controller.ts
├── services/
│   ├── user.service.ts
│   ├── email.service.ts
│   └── payment.service.ts
├── repositories/
│   └── user.repository.ts
├── models/
│   └── user.model.ts
├── types/
│   └── user.types.ts
└── middleware/
    └── validate.ts
```

## Migration Strategy

```markdown
## Phase 1: Create Service Layer (Week 1-2)

- [ ] Create service classes
- [ ] Move business logic to services
- [ ] Keep controllers thin
- [ ] No breaking changes

## Phase 2: Add Tests (Week 3-4)

- [ ] Write service unit tests
- [ ] Mock dependencies
- [ ] Achieve 80%+ coverage

## Phase 3: Extract Repositories (Week 5-6)

- [ ] Create repository layer
- [ ] Move DB queries from services
- [ ] Services depend on repositories

## Phase 4: Dependency Injection (Week 7-8)

- [ ] Set up DI container
- [ ] Remove manual instantiation
- [ ] Wire up dependencies
```

## Benefits

- **Testability**: Services testable without HTTP
- **Reusability**: Logic reused across endpoints
- **Separation**: Clear boundaries between layers
- **Maintainability**: Easier to locate and modify logic

## Output Checklist

- [ ] Service classes created
- [ ] Business logic extracted from controllers
- [ ] Repository layer for data access
- [ ] Dependency injection setup
- [ ] Unit tests for services
- [ ] Folder structure reorganized
- [ ] Migration plan documented
- [ ] Team trained on new patterns

© patricio0312rev · MIT · patricio0312rev/skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
nestjs-professional-software-engineering amirtaherkhani Скилл nestjs-professional-software-engineering для Claude Code и Cursor проектирует, реализует, рефакторит и проверяет код на NestJS и TypeScript. Запускается при разработке новых функций, исправлении багов и написании тестов. CX Codex +1 556установок nestjs-best-practices Kadajett Скилл nestjs-best-practices для Claude Code помогает писать, проверять и рефакторить код NestJS. Он подключается к задачам по архитектуре, безопасности и производительности. CX Codex +1 32 000установок vtex-io-service-runtime vtex Скилл vtex-io-service-runtime помогает собрать рантайм бэкенд-приложения VTEX IO: точку входа Service, типизированный контекст и настройки service.json. CX Codex +1 1 200установок encore-service encoredev Скилл encore-service помогает настроить сервисы и каталоги в проектах на Encore.ts. Пригодится при создании микросервисов и организации вызовов через ~encore/clients. CX Codex +1 878установок service-debugging c0x12c Скилл service-debugging для Claude Code задаёт пошаговый поиск причин сбоев в бэкенд-сервисах — от сбора симптомов и проверки логов до локализации бага через git bisect. CX Codex +1 ★ 111звёзд репо unit-test-service-layer giuseppe-trisciuoglio Скилл unit-test-service-layer задаёт агенту шаблон юнит-тестов сервисного слоя на Mockito: моки репозиториев, проверка вызовов, сценарии с исключениями. CX Codex +1 4 000установок

Из того же набора148

Весь набор →
llm-debugger Скилл llm-debugger находит причины сбоев в ответах нейросетей, правит системные промпты и генерирует регрессионные тесты для фиксации ошибок. CX Codex +1 259установок tool-function-schema-designer Скилл tool-function-schema-designer помогает описать инструменты для LLM так, чтобы модель вызывала их с валидными аргументами: JSON-схема, типы, проверка через zod и примеры вызовов. CX Codex +1 258установок test-reporting-triage-skill Скилл test-reporting-triage-skill для Claude Code группирует ошибки тестов по категориям, предлагает ответственные команды и варианты исправления. Разбирает результаты прогона тестов. CX Codex +1 257установок mocking-assistant Скилл mocking-assistant помогает создавать моки для API, сервисов и UI через MSW и Vitest: от фикстур данных до перехвата системного времени в тестах. CX Codex +1 256установок rag-pipeline-builder Скилл rag-pipeline-builder проектирует RAG-пайплайн для ассистента по документам: чанкинг, метаданные, гибридный поиск, реранкинг и план оценки качества. CX Codex +1 251установок preview-environments-builder Скилл preview-environments-builder генерирует пайплайны временных окружений для каждого пулл-реквеста с автоматическим развёртыванием, уникальным адресом и удалением ресурсов после закрытия PR. CX Codex +1 250установок load-test-scenario-builder Скилл load-test-scenario-builder проектирует сценарии нагрузочного тестирования, готовит k6-скрипты, профили трафика и критерии успеха для проверки пропускной способности. CX Codex +1 236установок graphql-schema-designer Скилл graphql-schema-designer для Claude Code помогает спроектировать GraphQL API с типами, запросами, мутациями, подписками и резолверами. Включается по запросам о схеме, настройке GraphQL или Apollo Server. CX Codex +1 230установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой