doctrine-events — скилл для Claude Code: что делает и как установить
Скилл doctrine-events для Claude помогает навесить побочный эффект на событие сущности Doctrine в Symfony: метки времени, слаг, поисковый индекс, уведомление.
MIT ★ 234 обновлён 2026-10-05
npx skills add dev-toolings/superpowers-symfony --skill doctrine-events -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/doctrine-events/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/doctrine-events/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-events -a codex2Вручную: положить файлы
.agents/skills/doctrine-events/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-events -a cursor2Вручную: положить файлы
.cursor/skills/doctrine-events/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dev-toolings/superpowers-symfony content/skills/doctrine-events2Вручную: положить файлы
.github/skills/doctrine-events/SKILL.md1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-events -a gemini-cli2Командой платформы
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/doctrine-eventsВручную: положить файлы
.devin/skills/doctrine-events/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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