# magento-module-developer

Скилл ведёт агента по разработке модулей Magento 2: структура каталогов, DI, сервис-контракты, репозитории и схема БД.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 438 установок · ★ 31
- Автор: maxnorm
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/maxnorm/magento2-agent-skills/tree/HEAD/skills/magento-module-developer/SKILL.md
- Обновлён: 2026-01-24
- HTML: https://affpapa.org/nevibecode/skills/magento-module-developer

## Что делает

Скилл описывает процесс создания модуля Magento 2 по шагам. Сначала планирование: разбор требований, проектирование архитектуры, сущностей и сервис-контрактов. Потом сборка каркаса — `app/code/Vendor/ModuleName/` с `etc/module.xml`, `di.xml`, `routes.xml`, `db_schema.xml` и `registration.php`. Дальше реализация: модели на `AbstractModel`, ресурсные модели, коллекции, репозитории в `Model/` с интерфейсами в `Api/`, контроллеры для фронтенда, админки и API.

Отдельные разделы посвящены паттернам: внедрение зависимостей через конструктор, плагины before/after вместо around, события и обсерверы, UI-компоненты для админ-гридов. Есть блоки про REST и GraphQL, кэширование, инвалидацию кэша и мультистор. Всё это ориентировано на Adobe Commerce best practices.

Скилл требует, чтобы код соответствовал PSR-12 и стандартам Magento, с `declare(strict_types=1);` в каждом PHP-файле. Если ваш проект живёт на другой кодовой базе или вы не пишете под Magento, скилл будет только мешать: он задаёт агенту жёсткие конвенции фреймворка. Полезен он там, где модуль нужно встроить в ядро без правок вендорного кода.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- собрать каркас модуля с `etc/module.xml` и `registration.php`
- описать таблицы в `db_schema.xml` и связать сущности
- вынести доступ к данным в репозитории с интерфейсами в `Api/`
- добавить админ-грид и форму через UI-компоненты
- подключить REST или GraphQL-эндпоинт к сервис-контракту

## Примеры запросов агенту
- Создай модуль Vendor_ModuleName для Magento 2 с репозиторием и сервис-контрактом
- Опиши таблицу заказов в `db_schema.xml` и сделай коллекцию
- Добавь плагин before к методу сохранения товара

## Похожие
- [hyva-create-module](https://affpapa.org/nevibecode/skills/hyva-create-module.md) — скилл · 1300 установок
- [woocommerce-backend-dev](https://affpapa.org/nevibecode/skills/woocommerce-backend-dev.md) — скилл · 2300 установок
- [fullstack-developer](https://affpapa.org/nevibecode/agents/fullstack-developer.md) — субагент · 18117 установок
- [php-development](https://affpapa.org/nevibecode/skills/php-development.md) — скилл · 1100 установок
- [laravel-expert](https://affpapa.org/nevibecode/skills/laravel-expert.md) — скилл · 449 установок
- [temporal-developer](https://affpapa.org/nevibecode/skills/temporal-developer.md) — скилл · 17 установок

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

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

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