# magento-model-developer

Скилл magento-model-developer помогает проектировать слой данных в Magento 2: строить модели, декларативные схемы db_schema.xml, репозитории и коллекции под EAV или плоские таблицы.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 210 установок · ★ 33 у репозитория
- Автор: maxnorm
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/maxnorm/magento2-agent-skills/tree/HEAD/skills/magento-model-developer/SKILL.md
- Обновлён: 2026-01-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/magento-model-developer

## Что делает

Скилл направляет агента при разработке архитектуры данных под Magento 2. Он содержит шаблоны сущностей на базе `AbstractModel`, ресурсных моделей на `AbstractDb`, коллекций и реализаций репозиториев с интерфейсами сервисных контрактов.

Внутри заложены правила выбора между EAV и плоскими таблицами: динамические атрибуты каталога отделяются от простых таблиц заказов. Скилл также задаёт структуру декларативных схем в `db_schema.xml` с первичными ключами и индексами `btree`.

Код генерируется в строгом режиме `declare(strict_types=1)` и требует соблюдения стандартов Magento 2 Framework, поэтому модулю нужны корректные пространства имён и интерфейсы.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add maxnorm/magento2-agent-skills --skill magento-model-developer -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add maxnorm/magento2-agent-skills --skill magento-model-developer -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add maxnorm/magento2-agent-skills --skill magento-model-developer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install maxnorm/magento2-agent-skills skills/magento-model-developer
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add maxnorm/magento2-agent-skills --skill magento-model-developer -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/maxnorm/magento2-agent-skills --path skills/magento-model-developer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add maxnorm/magento2-agent-skills --skill magento-model-developer -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/maxnorm/magento2-agent-skills/tree/HEAD/skills/magento-model-developer/SKILL.md

## Когда брать
- описать структуру таблицы модуля в `db_schema.xml` с индексами
- создать класс сущности, ресурсную модель и коллекцию
- написать репозиторий данных по сервисному контракту Magento 2
- выбрать архитектуру хранения между EAV и плоской таблицей

## Примеры запросов агенту
- Создай плоскую модель сущности с ресурсным классом и коллекцией для нового модуля.
- Сгенерируй репозиторий данных с методом поиска по идентификатору и выбросом исключения `NoSuchEntityException`.
- Напиши разметку `db_schema.xml` с первичным ключом и индексом для таблицы заказов.

## Похожие
- [hyva-create-module](https://affpapa.org/nevibecode/skills/hyva-create-module.md) — скилл · 1300 установок
- [data-model-designer](https://affpapa.org/nevibecode/skills/data-model-designer.md) — скилл · 116 установок
- [woocommerce-performance](https://affpapa.org/nevibecode/skills/woocommerce-performance.md) — скилл · 372 установки
- [hyva-render-media-image](https://affpapa.org/nevibecode/skills/hyva-render-media-image.md) — скилл · 1300 установок
- [planetscale-mcp-agent-operating-model](https://affpapa.org/nevibecode/skills/planetscale-mcp-agent-operating-model.md) — скилл · 2800 установок
- [developer-kit-php](https://affpapa.org/nevibecode/plugins/developer-kit-php.md) — плагин · ★ 372 у репозитория

Из того же набора: [maxnorm/magento2-agent-skills](https://affpapa.org/nevibecode/by/maxnorm/magento2-agent-skills.md) — 30 карточек

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

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