doctrine-transactions — скилл для Claude Code: описание и установка
Скилл doctrine-transactions настраивает транзакции в Doctrine ORM 3, блокировки и границы сброса изменений в Symfony. Пригодится при параллельной правке строк и сбоях flush.
MIT ★ 234 обновлён 2026-10-05
npx skills add dev-toolings/superpowers-symfony --skill doctrine-transactions -a claude-codeЧто делает doctrine-transactions
Скилл учит агента выносить границы транзакций в сервисный слой вместо контроллеров и группировать изменения под один вызов wrapInTransaction(). В Doctrine ORM 3 метод transactional() удалён, поэтому код сразу строится вокруг нового API с одиночным flush().
В логику закладывается выбор блокировок: оптимистичная через атрибут #[ORM\Version] для правок пользователей или пессимистичная PESSIMISTIC_WRITE для критических участков. Внутри транзакций и пессимистичных блокировок нельзя делать HTTP-запросы или слать почту, чтобы не держать соединение с базой открытым.
После сбоя сохранения, нарушения ограничений или отката скилл требует очищать EntityManager через метод clear(). Повторно использовать сущности из упавшего UnitOfWork нельзя: их нужно запрашивать из базы заново.
Какие задачи решает
- изолировать пачку связанных записей в БД через
wrapInTransaction()в ORM 3 - настроить оптимистичную блокировку с атрибутом
#[ORM\Version]против конфликтов правки - защитить критические участки базы через пессимистичную блокировку
PESSIMISTIC_WRITE - обработать сбой
flush()и очиститьEntityManagerпосле отката
Примеры запросов агенту
- Перепиши метод сохранения заказа на
wrapInTransaction()и настрой одинflush()в конце сервиса - Добавь версионирование
#[ORM\Version]в сущность статьи и обработайOptimisticLockException - Защити списание баланса с помощью
PESSIMISTIC_WRITEбез внешних HTTP-вызовов внутри транзакции
Как установить doctrine-transactions
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-transactions -a claude-code2Вручную: положить файлы
~/.claude/skills/doctrine-transactions/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/doctrine-transactions/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-transactions -a codex2Вручную: положить файлы
.agents/skills/doctrine-transactions/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-transactions -a cursor2Вручную: положить файлы
.cursor/skills/doctrine-transactions/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dev-toolings/superpowers-symfony content/skills/doctrine-transactions2Вручную: положить файлы
.github/skills/doctrine-transactions/SKILL.md1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-transactions -a gemini-cli2Командой платформы
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/doctrine-transactionsВручную: положить файлы
.devin/skills/doctrine-transactions/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о doctrine-transactions
Как установить doctrine-transactions в Claude Code?
Выполните команду npx skills add dev-toolings/superpowers-symfony --skill doctrine-transactions -a claude-code или сохраните файл по пути ~/.claude/skills/doctrine-transactions/SKILL.md.
Что делает скилл doctrine-transactions?
Он задаёт правила работы с транзакциями Doctrine в Symfony, требуя выносить границы в сервисы, применять wrapInTransaction() вместо устаревшего transactional() и сводить запись к одному flush().
Что делать с EntityManager при ошибке отката?
После отката транзакции или нарушения ограничений нужно очистить EntityManager и заново запросить нужные сущности из базы данных. Использовать объекты из упавшего блока работы запрещено.
Исходный текст
SKILL.md · MIT
--- name: doctrine-transactions description: Handle Doctrine transactions (ORM 3 wrapInTransaction), optimistic/pessimistic locking, flush strategies, and transaction boundaries 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 Transactions (Symfony) ## Use when - Several writes must succeed or fail together. - Two users or workers can edit the same row concurrently. - Deciding where to flush and who owns the transaction boundary. - Recovering after a failed flush, a constraint violation, or a lost connection. ## Default workflow 1. Place the transaction boundary in the service layer, not in the controller. 2. Group related changes and flush once, inside `wrapInTransaction()`. 3. Pick the concurrency strategy: `#[ORM\Version]` optimistic locking for edits, `PESSIMISTIC_WRITE` for short critical sections. 4. Handle `OptimisticLockException` and constraint violations explicitly. 5. After a rollback, clear the EntityManager and re-fetch what you still need. ## Guardrails - On ORM 3, `EntityManager::transactional()` is gone: use `wrapInTransaction()`. - Outside an explicit transaction each flush commits on its own, so avoid several flushes per operation. - Keep transactions and pessimistic locks short; no HTTP calls or mail inside. - Do not reuse entities from a failed unit of work. ## Progressive disclosure - Use this file for execution posture and risk controls. - Open references when deep implementation details are needed. ## Output contract - Transaction boundaries with a single flush per operation. - The locking strategy chosen per entity, and how conflicts reach the user. - Rollback handling and the state of the EntityManager after it. ## References - `reference.md`
© dev-toolings · MIT · dev-toolings/superpowers-symfony