# doctrine-relations

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 234 у репозитория
- Автор: dev-toolings
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/dev-toolings/superpowers-symfony/tree/HEAD/content/skills/doctrine-relations/SKILL.md
- Обновлён: 2026-10-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill doctrine-relations -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/doctrine-relations/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/doctrine-relations/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill doctrine-relations -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/doctrine-relations/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill doctrine-relations -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/doctrine-relations/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dev-toolings/superpowers-symfony content/skills/doctrine-relations
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/doctrine-relations/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dev-toolings/superpowers-symfony --skill doctrine-relations -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dev-toolings/superpowers-symfony --path content/skills/doctrine-relations
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/doctrine-relations/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dev-toolings/superpowers-symfony/tree/HEAD/content/skills/doctrine-relations/SKILL.md

## Когда брать
- выбрать владеющую и обратную стороны связи
- инициализировать коллекции и синхронизировать обе стороны
- избежать N+1 запросов через fetch joins
- настроить каскадные операции и удаление сирот
- работать с несколькими entity managers

## Примеры запросов агенту
- Помогите мне настроить ManyToOne связь между Post и Author с правильным inversedBy и mappedBy
- Как избежать N+1 запросов при загрузке коллекции комментариев к статье?
- Нужно разделить сущности между двумя entity managers — как правильно настроить связи?

## Похожие
- [php-symfony](https://affpapa.org/nevibecode/rules/php-symfony.md) — правило · ★ 41430 у репозитория
- [symfony-specialist](https://affpapa.org/nevibecode/agents/symfony-specialist.md) — субагент · ★ 26718 у репозитория
- [eloquent-best-practices](https://affpapa.org/nevibecode/skills/eloquent-best-practices.md) — скилл · 1300 установок
- [prisma-driver-adapter-implementation](https://affpapa.org/nevibecode/skills/prisma-driver-adapter-implementation.md) — скилл · 425600 установок
- [django-perf-review](https://affpapa.org/nevibecode/skills/django-perf-review.md) — скилл · 3200 установок
- [sqlalchemy-alembic-expert-best-practices-code-review](https://affpapa.org/nevibecode/skills/sqlalchemy-alembic-expert-best-practices-code-review.md) — скилл · 2200 установок

Из того же набора: [dev-toolings/superpowers-symfony](https://affpapa.org/nevibecode/by/dev-toolings/superpowers-symfony.md) — 51 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
