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

controller-cleanup — скилл для Claude Code

Скилл controller-cleanup переносит бизнес-логику из толстых контроллеров Symfony в сервисы, обработчики и команды. Оставляет в действии только делегирование и ответ.

MIT ★ 234 обновлён 2026-10-05

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

Что делает controller-cleanup

Скилл читает контроллер, составляет список операций — валидация, авторизация, логика, сохранение — и выносит каждую в свой слой. Перед переносом покрывает действие функциональным тестом, чтобы HTTP-поведение осталось прежним: те же коды, те же ответы. Входные данные привязывает к DTO через #[MapRequestPayload] или #[MapQueryString], авторизацию переносит в voter, побочные эффекты — в события или сообщения.

Сервисы внедряются через аргументы конструктора или метода, прямые обращения к контейнеру запрещены. Логика не перемещается в «manager», который остаётся старым контроллером под новым именем. Консольные команды пишутся как invokable-классы с #[AsCommand] (Symfony 7.3+) и используют те же сервисы.

Выход — действие в пять-десять строк, извлечённые DTO, сервисы, voter или обработчики с одной ответственностью у каждого, тесты, подтверждающие, что HTTP-поведение не изменилось.

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

  • вынести бизнес-логику из контроллера в сервисы и обработчики
  • покрыть действие функциональным тестом перед рефакторингом
  • привязать входные данные к DTO через #[MapRequestPayload]
  • переместить авторизацию в voter, побочные эффекты в события
  • написать консольную команду как invokable-класс с #[AsCommand]

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

  • Разбери контроллер UserController::register на сервисы — валидацию, создание пользователя и отправку письма
  • Покрой действие POST /orders функциональным тестом, потом вынеси логику в CreateOrderHandler
  • Перепиши app:import-products как invokable-команду, которая делегирует ProductImporter

Как установить controller-cleanup

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill controller-cleanup -a claude-code

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

~/.claude/skills/controller-cleanup/SKILL.md

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

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

Вопросы о controller-cleanup

Как установить controller-cleanup в Claude Code?

Выполни npx skills add dev-toolings/superpowers-symfony --skill controller-cleanup -a claude-code, путь к скиллу — ~/.claude/skills/controller-cleanup/SKILL.md.

Что делает скилл controller-cleanup?

Переносит бизнес-логику, валидацию и авторизацию из контроллеров Symfony в сервисы, DTO, voter и обработчики. Действие остаётся коротким — только делегирование и ответ.

Как controller-cleanup сохраняет HTTP-поведение?

Перед рефакторингом скилл покрывает действие функциональным тестом, чтобы коды ответов и тела остались прежними. После переноса логики тест подтверждает, что ничего не сломалось.

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

SKILL.md · MIT
---
name: controller-cleanup
description: Refactor fat controllers into lean ones by extracting business logic to services, handlers, and invokable commands
capabilities: [read, search]
tags: [architecture]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
---

# Controller Cleanup (Symfony)

## Use when
- A controller action holds business logic, queries, or more than a handful of lines.
- Input parsing, validation, authorization and persistence are mixed in one action.
- A console command does the real work itself instead of delegating it.

## Default workflow
1. List what the action does: input, validation, authorization, business logic, persistence, side effects.
2. Cover the current HTTP behavior with a functional test before moving anything.
3. Map input to a DTO with `#[MapRequestPayload]` or `#[MapQueryString]` and let the validator reject it.
4. Move business logic into a service or a command handler, authorization into a voter, side effects into events or messages.
5. Leave the action to resolve, authorize, delegate and respond, in five to ten lines.

## Guardrails
- Type-hint services as arguments or constructor parameters; never pull them from the container.
- Keep the HTTP behavior identical: same status codes, same payloads.
- Do not move the logic into a "manager" that is the old controller under a new name.
- Write console entry points as invokable `#[AsCommand]` classes (Symfony 7.3+) that delegate to the same services.

## Progressive disclosure
- Use this file for execution posture and risk controls.
- Open references when deep implementation details are needed.

## Output contract
- Lean actions that delegate.
- The extracted DTOs, services, voters or handlers, one responsibility each.
- Functional tests showing the HTTP behavior is unchanged.

## References
- `reference.md`

© dev-toolings · MIT · dev-toolings/superpowers-symfony

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

Все скиллы по теме «Бэкенд и API» →
php-refactor-expert Giuseppe Trisciuoglio Субагент php-refactor-expert разбирает PHP-код и предлагает рефакторинг с сохранением поведения. Запускайте его после реализации функции или когда код трудно читать и поддерживать. CX Codex ★ 372звёзд репо clean-architecture Giuseppe Trisciuoglio Скилл clean-architecture раскладывает PHP-проект на слои Domain, Application, Adapter и Infrastructure и даёт шаблоны сущностей, value objects и портов без привязки к Symfony. CX Codex +1 ★ 372звёзд репо symfony-security-auditor reason-machines Скилл symfony-security-auditor ищет логические уязвимости и сбои контроля доступа в проектах на Symfony. Запускает двух агентов для взаимной проверки находок перед выдачей отчёта. CX Codex +1 239установок sentry-php-sdk getsentry Скилл sentry-php-sdk помогает настроить мониторинг Sentry в проектах на чистом PHP, Laravel или Symfony. Распознаёт фреймворк, очереди и планировщики, после чего предлагает нужные пакеты и конфигурацию. CX Codex +1 2 400установок appwrite-php appwrite Скилл appwrite-php подсказывает агенту, как писать серверный PHP под Appwrite: пользователи, таблицы, файлы, функции. Пригодится в Laravel и Symfony. CX Codex +1 898установок php-expert personamanagmentlayer Скилл php-expert для Claude Code задаёт агенту правила работы с PHP 8+, Laravel, Composer и PHPUnit. Охватывает разработку, тестирование и ревью современного PHP-кода. CX Codex +1 269установок

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

Весь набор →
config-env-parameters Скилл config-env-parameters для Claude Code помогает менять переменные окружения, параметры и секреты Symfony с учётом разных сред. Задаёт значения и внедряет их в приложение. CX Codex +1 ★ 234звёзд репо doctrine-fixtures-foundry Скилл doctrine-fixtures-foundry для Claude Code учит создавать тестовые данные Doctrine через фабрики Zenstruck Foundry v2: состояния, последовательности и связи. Срабатывает при написании фикстур и миграции фабрик с Foundry v1. CX Codex +1 ★ 234звёзд репо doctrine-transactions Скилл doctrine-transactions настраивает транзакции в Doctrine ORM 3, блокировки и границы сброса изменений в Symfony. Пригодится при параллельной правке строк и сбоях flush. CX Codex +1 ★ 234звёзд репо doctrine-batch-processing Скилл doctrine-batch-processing для Claude Code обрабатывает большие наборы данных через Doctrine без загрузки всех сущностей в память. Выполняет импорт, экспорт и массовые изменения. CX Codex +1 ★ 234звёзд репо brainstorming Скилл brainstorming структурирует проектирование фич в Symfony: собирает требования, подбирает компоненты фреймворка и сравнивает варианты архитектуры до написания кода. CX Codex +1 ★ 234звёзд репо runner-selection Скилл runner-selection для Claude Code определяет, где запускать PHP-, Composer-, консольные и тестовые команды: в Docker, DDEV или на хосте. Проверяет окружение и задаёт префикс команд. CX Codex +1 ★ 234звёзд репо doctrine-events Скилл doctrine-events для Claude помогает навесить побочный эффект на событие сущности Doctrine в Symfony: метки времени, слаг, поисковый индекс, уведомление. CX Codex +1 ★ 234звёзд репо form-types-validation Скилл form-types-validation помогает проектировать формы Symfony, настраивать валидацию сущностей и DTO, обрабатывать код 422 и собирать многошаговые сценарии. CX Codex +1 ★ 234звёзд репо

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

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