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

doctrine-events — скилл для Claude Code: что делает и как установить

Скилл doctrine-events для Claude помогает навесить побочный эффект на событие сущности Doctrine в Symfony: метки времени, слаг, поисковый индекс, уведомление.

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

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

Что делает doctrine-events

Скилл разбирает три способа повесить побочный эффект на жизненный цикл сущности Doctrine в Symfony: колбэк, слушатель сущности и глобальный слушатель жизненного цикла. Выбор идёт от узкого к широкому — колбэк для одной сущности без зависимостей, слушатель сущности там, где нужны сервисы, глобальный слушатель для сквозной логики по всем сущностям.

Подключение идёт атрибутами: #[ORM\HasLifecycleCallbacks], #[AsEntityListener], #[AsDoctrineListener]. Аргумент события типизируется своим классом — PostPersistEventArgs, PreUpdateEventArgs и так далее. В reference.md лежат таблица аргументов по событиям и разбор переезда с подписчиков.

Границы жёсткие. Слушатели на атрибутах рассчитаны на ORM 3, а подписчики на EventSubscriberInterface из 3.0 убраны. flush() внутри обработчика портит незавершённый unit of work, поэтому скилл его запрещает. В preUpdate менять поля можно только через $args->setNewValue(), связи трогать нельзя. Проверка эффекта — функциональный тест на реальной БД.

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

  • проставить createdAt и updatedAt при сохранении сущности
  • перевести подписчик на EventSubscriberInterface на атрибуты ORM 3
  • выбрать между колбэком, слушателем сущности и глобальным слушателем
  • обновить поисковый индекс после postPersist
  • не сломать unit of work вызовом flush() из обработчика

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

  • Повесь на сущность Article слушатель, который обновляет поисковый индекс после сохранения.
  • Переведи наш подписчик на EventSubscriberInterface на атрибуты ORM 3.
  • Почему в preUpdate не применяется новое значение поля? Перепиши через setNewValue().

Как установить doctrine-events

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill doctrine-events -a claude-code

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

~/.claude/skills/doctrine-events/SKILL.md

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

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

Вопросы о doctrine-events

Как установить doctrine-events в Claude Code?

Выполните npx skills add dev-toolings/superpowers-symfony --skill doctrine-events -a claude-code. Файл скилла окажется по пути ~/.claude/skills/doctrine-events/SKILL.md.

Что делает doctrine-events?

Подсказывает, как отреагировать на событие жизненного цикла сущности Doctrine в Symfony: выбирает механизм, пишет класс слушателя или колбэка с нужным атрибутом и проверяет, что эффект сработал.

Чем слушатель сущности отличается от глобального слушателя жизненного цикла?

Слушатель сущности привязан к одному классу и может получать сервисы. Глобальный срабатывает для всех сущностей, поэтому тип сущности в нём проверяют в начале обработчика.

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

SKILL.md · MIT
---
name: doctrine-events
description: React to Doctrine entity lifecycle in Symfony with attribute listeners (#[AsDoctrineListener]/#[AsEntityListener], ORM 3) and lifecycle callbacks
capabilities: [read, search, edit, shell]
tags: [doctrine]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
---

# Doctrine Events (Symfony)

## Use when
- You need side effects on entity persistence (timestamps, slugs, search indexing, notifications).
- Migrating an `EventSubscriberInterface` Doctrine subscriber to ORM 3.
- Choosing between lifecycle callbacks, entity listeners, and global lifecycle listeners.

## Default workflow
1. Pick the narrowest mechanism: callback (one entity, no deps) → entity listener (one entity, needs services) → lifecycle listener (cross-cutting, all entities).
2. Wire it with attributes (`#[ORM\HasLifecycleCallbacks]`, `#[AsEntityListener]`, `#[AsDoctrineListener]`).
3. Type the event argument by its per-event class (`PostPersistEventArgs`, `PreUpdateEventArgs`, …).
4. Verify the side effect fires with a targeted functional test against a real DB.

## Guardrails
- ORM 3.0 removed `EventSubscriberInterface` Doctrine subscribers — never reintroduce them.
- Type-check the entity early in a global lifecycle listener (it fires for every entity).
- Never call `flush()` inside a Doctrine event handler — it corrupts the in-flight unit of work.
- `preUpdate` is restricted: change fields only via `$args->setNewValue()`, never touch associations.

## Progressive disclosure
- Use this file for execution posture and risk controls.
- Open `reference.md` for the three mechanisms, the event-args matrix, and migration from subscribers.

## Output contract
- Listener/callback class with the correct attribute.
- Justification for the chosen mechanism.
- Validation outcomes (test that the side effect fired).

## References
- `reference.md`

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

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

Все скиллы по теме «Бэкенд и API» →
php-symfony официальный github Правило php-symfony для GitHub Copilot, которое держит генерацию кода в рамках официальных практик Symfony. Применяется к PHP, YAML, XML и Twig-файлам, когда ИИ дописывает контроллеры, конфиги или шаблоны. CX Codex +1 ★ 41 430звёзд репо symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо supabase-webhooks-events Jeremy Longshore Скилл supabase-webhooks-events помогает настроить вебхуки Supabase, асинхронные HTTP-запросы через pg_net, события LISTEN/NOTIFY и приёмники Edge Functions с проверкой HMAC-подписи. CX Codex +1 1установок gws-events официальный googleworkspace Скилл gws-events для Claude Code подключает Google Workspace Events к агенту и даёт команды для подписок, операций, задач и потоковых обновлений. CX Codex +1 32 500установок eloquent-best-practices iSerter Скилл eloquent-best-practices задаёт правила работы с Laravel Eloquent: от жадной загрузки связей до защиты от массового заполнения. Помогает писать быстрые выборки без проблемы N+1. CX Codex +1 1 300установок inngest-events inngest Скилл inngest-events помогает проектировать событийные воркфлоу Inngest: имена событий, идемпотентность по id, fan-out и системные события. CX Codex +1 4 000установок

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

Весь набор →
doctrine-batch-processing Скилл doctrine-batch-processing для Claude Code обрабатывает большие наборы данных через Doctrine без загрузки всех сущностей в память. Выполняет импорт, экспорт и массовые изменения. CX Codex +1 ★ 234звёзд репо controller-cleanup Скилл controller-cleanup переносит бизнес-логику из толстых контроллеров Symfony в сервисы, обработчики и команды. Оставляет в действии только делегирование и ответ. 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звёзд репо form-types-validation Скилл form-types-validation помогает проектировать формы Symfony, настраивать валидацию сущностей и DTO, обрабатывать код 422 и собирать многошаговые сценарии. CX Codex +1 ★ 234звёзд репо tdd-with-phpunit Скилл tdd-with-phpunit для Claude Code ведёт разработку тестами в Symfony: проверяет падение PHPUnit-теста, его прохождение и рефакторинг. Охватывает тесты команд, форм и внешних интеграций. CX Codex +1 ★ 234звёзд репо using-symfony-superpowers Скилл using-symfony-superpowers для Claude Code определяет версию Symfony, выбирает нужный скилл и выстраивает порядок действий для сложных задач. CX Codex +1 ★ 234звёзд репо interfaces-and-autowiring Скилл interfaces-and-autowiring настраивает внедрение зависимостей в проектах на Symfony: привязывает интерфейсы, расставляет атрибуты #[Target], #[Autowire] и декорирует сервисы без правок контейнера вручную. CX Codex +1 ★ 234звёзд репо

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

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