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

doctrine-relations — скилл для Claude Code: связи Doctrine

Скилл doctrine-relations помогает настроить связи между сущностями Doctrine (OneToMany, ManyToMany, ManyToOne) с правильным выбором сторон, каскадными операциями и защитой от N+1 запросов.

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

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

Что делает 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-code

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

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

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Бэкенд и 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звёзд репо eloquent-best-practices iSerter Скилл eloquent-best-practices задаёт правила работы с Laravel Eloquent: от жадной загрузки связей до защиты от массового заполнения. Помогает писать быстрые выборки без проблемы N+1. CX Codex +1 1 300установок prisma-driver-adapter-implementation prisma Скилл prisma-driver-adapter-implementation для Claude Code описывает реализацию SQL-адаптеров Prisma ORM 7. Включается при работе с транзакциями, savepoint-ами, маппингом значений и ошибками БД. CX Codex +1 425 600установок django-perf-review getsentry Скилл django-perf-review проверяет Django-код на N+1 запросы, неограниченные queryset и отсутствующие индексы. Пригодится перед релизом или когда страница тормозит на больших таблицах. CX Codex +1 3 200установок sqlalchemy-alembic-expert-best-practices-code-review wispbit Скилл sqlalchemy-alembic-expert-best-practices-code-review для Claude Code помогает писать и проверять модели SQLAlchemy, миграции Alembic и запросы к БД. Активируется при изменениях схемы и оптимизации запросов. CX Codex +1 2 200установок

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

Весь набор →
doctrine-migrations Скилл doctrine-migrations помогает создавать и проверять миграции Doctrine, откатывать версии и готовить их к запуску в production. Пригодится при изменениях схемы Symfony-приложения. CX Codex +1 ★ 234звёзд репо symfony-messenger Скилл для работы с асинхронными сообщениями через Symfony Messenger: настройка транспортов, обработчиков и стратегий повтора. CX Codex +1 ★ 234звёзд репо api-platform-security Скилл api-platform-security настраивает правила доступа в Symfony API Platform через выражения security, воутеры и хуки жизненного цикла операций. CX Codex +1 ★ 234звёзд репо e2e-panther-playwright Скилл e2e-panther-playwright для Claude Code помогает писать E2E-тесты Symfony: Panther запускает реальный браузер, Playwright берёт сложные сценарии. Тесты проверяют поведение JavaScript, невидимое WebTestCase. CX Codex +1 ★ 234звёзд репо doctrine-fetch-modes Скилл doctrine-fetch-modes помогает настроить выборку данных в Doctrine ORM и DBAL 4 для Symfony: устраняет проблему N+1, переводит чтение на DTO и конфигурирует отложенную загрузку. CX Codex +1 ★ 234звёзд репо api-platform-resources Скилл api-platform-resources для Claude Code настраивает ресурсы API Platform для REST и GraphQL. Подключается при создании ресурса или настройке операций, пагинации и OpenAPI. CX Codex +1 ★ 234звёзд репо messenger-retry-failures Скилл messenger-retry-failures разбирает сбои обработчиков Symfony Messenger: когда сообщение стоит повторить, когда сразу отправить в failure transport и как потом достать его оттуда. CX Codex +1 ★ 234звёзд репо api-platform-state-providers Скилл api-platform-state-providers помогает настроить кастомные State Provider и Processor в API Platform и Symfony. Отвязывает выборку и сохранение данных от сущностей Doctrine. CX Codex +1 ★ 234звёзд репо

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

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