doctrine-relations — скилл для Claude Code: связи Doctrine
Скилл doctrine-relations помогает настроить связи между сущностями Doctrine (OneToMany, ManyToMany, ManyToOne) с правильным выбором сторон, каскадными операциями и защитой от N+1 запросов.
MIT ★ 234 обновлён 2026-10-05
npx skills add dev-toolings/superpowers-symfony --skill doctrine-relations -a claude-codeЧто делает doctrine-relations
Doctrine Relations задаёт правила для определения связей между сущностями. Скилл помогает выбрать владеющую сторону (с внешним ключом) и обратную, инициализировать коллекции через ArrayCollection, написать синхронизирующие методы addX() и removeX(). Подсказывает, когда использовать cascade: ['persist'] для агрегатов, сохраняемых вместе, и orphanRemoval: true только для настоящей композиции.
Для больших коллекций рекомендует fetch: 'EXTRA_LAZY' или проверку принадлежности со стороны владельца. Добавляет fetch joins в горячих местах кода, чтобы избежать N+1 запросов. Если проект использует несколько entity managers, скилл следит, чтобы каждая сущность оставалась в одном менеджере, и помогает получать репозитории через ManagerRegistry.
Скилл работает с инструментами Read, Glob, Grep, Write, Edit и Bash, чтобы читать маппинги, искать места с N+1, редактировать сущности и запускать doctrine:schema:validate.
Какие задачи решает
- выбрать владеющую и обратную стороны связи
- инициализировать коллекции и синхронизировать обе стороны
- избежать N+1 запросов через fetch joins
- настроить каскадные операции и удаление сирот
- работать с несколькими entity managers
Примеры запросов агенту
- Помогите мне настроить ManyToOne связь между Post и Author с правильным inversedBy и mappedBy
- Как избежать N+1 запросов при загрузке коллекции комментариев к статье?
- Нужно разделить сущности между двумя entity managers — как правильно настроить связи?
Как установить doctrine-relations
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-relations -a claude-code2Вручную: положить файлы
~/.claude/skills/doctrine-relations/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/doctrine-relations/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-relations -a codex2Вручную: положить файлы
.agents/skills/doctrine-relations/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-relations -a cursor2Вручную: положить файлы
.cursor/skills/doctrine-relations/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dev-toolings/superpowers-symfony content/skills/doctrine-relations2Вручную: положить файлы
.github/skills/doctrine-relations/SKILL.md1Через Skills CLI (Vercel)
npx skills add dev-toolings/superpowers-symfony --skill doctrine-relations -a gemini-cli2Командой платформы
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/doctrine-relationsВручную: положить файлы
.devin/skills/doctrine-relations/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о doctrine-relations
Как установить doctrine-relations в Claude Code?
Выполните команду npx skills add dev-toolings/superpowers-symfony --skill doctrine-relations -a claude-code, потом откройте ~/.claude/skills/doctrine-relations/SKILL.md.
Что делает doctrine-relations?
Скилл помогает определить связи между сущностями Doctrine (ManyToOne, OneToMany, ManyToMany), выбрать владеющую сторону, настроить каскадные операции и защитить код от N+1 запросов через fetch joins и оптимизированные стратегии загрузки.
Какие инструменты использует скилл?
Скилл работает с Read, Glob, Grep для поиска и анализа маппингов, Write и Edit для редактирования сущностей, и Bash для запуска команд валидации вроде doctrine:schema:validate.
Исходный текст
SKILL.md · MIT
--- name: doctrine-relations description: Define Doctrine entity relationships (OneToMany, ManyToMany, ManyToOne); configure cascade, orphan removal, multiple entity managers; prevent N+1 queries 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 Relations (Symfony) ## Use when - Mapping a `ManyToOne`, `OneToMany`, `ManyToMany` or `OneToOne` and choosing the owning side. - Deciding between `cascade` and `orphanRemoval` for child entities. - A relation does not persist (only the inverse side was set), or `contains()` is slow on a large inverse collection. - Splitting entities across several entity managers. ## Default workflow 1. Pick the owning side (holds the foreign key, `ManyToOne` with `inversedBy`) and the inverse side (`OneToMany` with `mappedBy`). 2. Initialize collections with `ArrayCollection` in the constructor, and write `addX()` and `removeX()` helpers that keep both sides in sync. 3. Use `cascade: ['persist']` for aggregates saved together, and `orphanRemoval: true` only for true composition. 4. Mark large inverse collections `fetch: 'EXTRA_LAZY'`, or test membership from the owning side. 5. Add fetch joins where a use case reads the relation, to avoid N+1 queries. 6. With several entity managers, keep each entity set in one manager and fetch repositories through `ManagerRegistry`. ## Guardrails - Doctrine persists what the owning side holds: always set the `ManyToOne` reference. - Avoid `cascade: ['remove']` on large collections (one DELETE per row), and never use `orphanRemoval` on shared entities. - A relation cannot span two entity managers. - For a non-default entity manager, fetch repositories with `ManagerRegistry::getRepository(Entity::class, 'name')`. ## Progressive disclosure - Use this file for execution posture and risk controls. - Open references when deep implementation details are needed. ## Output contract - Entity mappings with the owning and inverse sides, cascade and orphan decisions. - Fetch strategy for large collections and hot paths. - Result of `doctrine:schema:validate`. ## References - `reference.md`
© dev-toolings · MIT · dev-toolings/superpowers-symfony