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

magento-model-developer — скилл для Claude Code: обзор

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

MIT 210 установок ★ 33 обновлён 2026-01-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add maxnorm/magento2-agent-skills --skill magento-model-developer -a claude-code
Открыть на GitHub

Что делает magento-model-developer

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

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

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

Какие задачи решает

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

Примеры запросов агенту

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

Как установить magento-model-developer

1Через Skills CLI (Vercel)

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/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о magento-model-developer

Как установить magento-model-developer в Claude Code?

Выполните в терминале команду npx skills add maxnorm/magento2-agent-skills --skill magento-model-developer -a claude-code.

Что делает скилл magento-model-developer?

Он инструктирует ассистента создавать классы моделей, коллекций, ресурсных моделей и репозиториев по стандартам Magento 2.

Когда скилл рекомендует использовать EAV вместо обычных таблиц?

Подход EAV применяется для сущностей со множеством гибких опциональных атрибутов, таких как товары и категории, а плоские таблицы служат для простых структур вроде заказов.

Исходный текст

SKILL.md · MIT
---
name: magento-model-developer
description: Designs and implements data layer architecture for Magento 2. Use when creating data models, designing database schemas, implementing repositories, or working with EAV/flat table structures. Masters entity design, repository patterns, collections, and database optimization.
---

# Magento 2 Model Developer

Expert specialist in designing and implementing robust data layer architectures, creating efficient, scalable data models that serve as the foundation for enterprise e-commerce applications.

## When to Use

- Creating data models and entities
- Designing database schemas
- Implementing repository patterns
- Working with EAV or flat table structures
- Optimizing database queries
- Building data collections

## Data Architecture

- **Model Design**: Create efficient entity models following Magento patterns
- **EAV vs Flat Tables**: Choose optimal data storage strategies for different scenarios
- **Repository Pattern**: Implement clean data access layers and service contracts
- **Collection Optimization**: Build high-performance data collections and queries
- **Database Schema Design**: Design normalized, efficient database structures

## Model Development Process

### 1. Data Requirements Analysis
- **Business Requirements**: Understand entity relationships and business rules
- **Performance Requirements**: Plan for expected data volume and query patterns
- **Storage Strategy**: Choose between EAV and flat table storage approaches
- **Relationship Mapping**: Design entity relationships and dependencies
- **Scalability Planning**: Plan for future growth and data expansion

### 2. Database Schema Design
- **Table Structure**: Design efficient table structures and relationships
- **Data Types**: Choose appropriate data types for optimal storage and performance
- **Indexing Strategy**: Plan indexes for search, sorting, and filtering operations
- **Constraints**: Implement proper database constraints and validation
- **Migration Scripts**: Create database migration and upgrade scripts

### 3. Model Implementation
- **Entity Classes**: Implement model classes with proper validation and logic
- **Resource Models**: Create efficient database interaction layers
- **Collection Development**: Build optimized collection classes with filtering
- **Repository Implementation**: Create repository classes following service contracts
- **Factory Classes**: Implement proper object factories and builders

### 4. Integration & Testing
- **API Integration**: Integrate models with REST and GraphQL APIs
- **Cache Integration**: Implement proper caching strategies for model data
- **Performance Testing**: Validate model performance under expected load
- **Data Validation**: Test data integrity and validation rules
- **Migration Testing**: Test database migrations and data consistency

## Model Types

### Entity Model
```php
<?php

declare(strict_types=1);

namespace Vendor\Module\Model;

use Magento\Framework\Model\AbstractModel;
use Vendor\Module\Model\ResourceModel\Entity as ResourceModel;

class Entity extends AbstractModel
{
    protected function _construct(): void
    {
        $this->_init(ResourceModel::class);
    }
}
```

### Resource Model
```php
<?php

declare(strict_types=1);

namespace Vendor\Module\Model\ResourceModel;

use Magento\Framework\Model\ResourceModel\Db\AbstractDb;

class Entity extends AbstractDb
{
    protected function _construct(): void
    {
        $this->_init('vendor_module_entity', 'entity_id');
    }
}
```

### Collection
```php
<?php

declare(strict_types=1);

namespace Vendor\Module\Model\ResourceModel\Entity;

use Magento\Framework\Model\ResourceModel\Db\Collection\AbstractCollection;
use Vendor\Module\Model\Entity;
use Vendor\Module\Model\ResourceModel\Entity as ResourceModel;

class Collection extends AbstractCollection
{
    protected function _construct(): void
    {
        $this->_init(Entity::class, ResourceModel::class);
    }
}
```

### Repository Implementation
```php
<?php

declare(strict_types=1);

namespace Vendor\Module\Model;

use Vendor\Module\Api\Data\EntityInterface;
use Vendor\Module\Api\EntityRepositoryInterface;
use Vendor\Module\Model\ResourceModel\Entity as ResourceModel;
use Magento\Framework\Exception\NoSuchEntityException;

class EntityRepository implements EntityRepositoryInterface
{
    /**
     * @param ResourceModel $resource
     */
    public function __construct(
        private readonly ResourceModel $resource
    ) {
    }

    /**
     * @param int $id
     * @return EntityInterface
     * @throws NoSuchEntityException
     */
    public function getById(int $id): EntityInterface
    {
        $entity = $this->resource->load($id);
        if (!$entity->getId()) {
            throw new NoSuchEntityException(__('Entity with id "%1" does not exist.', $id));
        }
        return $entity;
    }
}
```

## Database Schema (db_schema.xml)

```xml
<?xml version="1.0"?>
<schema xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xsi:noNamespaceSchemaLocation="urn:magento:framework:Setup/Declaration/Schema/etc/schema.xsd">
    <table name="vendor_module_entity" resource="default" engine="innodb" comment="Entity Table">
        <column xsi:type="int" name="entity_id" unsigned="true" nullable="false" identity="true" comment="Entity ID"/>
        <column xsi:type="varchar" name="name" length="255" nullable="false" comment="Name"/>
        <column xsi:type="timestamp" name="created_at" nullable="false" default="CURRENT_TIMESTAMP" comment="Created At"/>
        <constraint xsi:type="primary" referenceId="PRIMARY">
            <column name="entity_id"/>
        </constraint>
        <index referenceId="VENDOR_MODULE_ENTITY_NAME" indexType="btree">
            <column name="name"/>
        </index>
    </table>
</schema>
```

## EAV vs Flat Tables

### EAV (Entity-Attribute-Value)
- Use for entities with many optional attributes
- Flexible attribute management
- Higher query complexity
- Use for products, customers, categories

### Flat Tables
- Use for entities with fixed attributes
- Better query performance
- Simpler data model
- Use for orders, quotes, simple entities

## Best Practices

### Performance
- **Query Optimization**: Optimize database queries and eliminate N+1 problems
- **Index Strategy**: Design efficient database indexing
- **Collection Optimization**: Use proper filters and pagination
- **Lazy Loading**: Implement lazy loading for expensive operations
- **Caching**: Cache frequently accessed data

### Data Integrity
- **Validation**: Implement comprehensive data validation
- **Constraints**: Use database constraints where appropriate
- **Transactions**: Use transactions for multi-step operations
- **Referential Integrity**: Maintain proper foreign key relationships
- **Data Consistency**: Ensure data consistency across operations

### Code Quality
- **Service Contracts**: Use interfaces for repositories
- **Type Hints**: Use proper type hints throughout
- **Error Handling**: Comprehensive error handling
- **Documentation**: Document data models and relationships
- **Testing**: Write tests for models and repositories

## References

- [Adobe Commerce Models](https://developer.adobe.com/commerce/php/development/components/model/)
- [Repository Pattern](https://developer.adobe.com/commerce/php/development/components/repository-pattern/)
- [Database Schema](https://developer.adobe.com/commerce/php/development/components/declarative-schema/)

Focus on creating efficient, scalable data models that serve as a solid foundation for enterprise applications.

© maxnorm · MIT · maxnorm/magento2-agent-skills

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

Все скиллы по теме «Бэкенд и API» →
hyva-create-module hyva-themes Скилл hyva-create-module для Claude Code. Создаёт заготовку модуля Magento 2 в app/code/: registration.php, composer.json и etc/module.xml без ручного копирования шаблонов. CX Codex +1 1 300установок data-model-designer datadrivenconstruction Скилл data-model-designer для Claude Code, Codex, Cursor и других агентов: проектирует модели данных строительных проектов — сущности, связи, схемы. Генерирует SQL DDL, JSON Schema и ER-диаграммы в формате Mermaid. CX Codex +1 116установок woocommerce-performance woocommerce Скилл woocommerce-performance находит узкие места в PHP-коде WooCommerce при работе с базой данных и кэшем. Пригодится при написании запросов и выводе списков товаров. CX Codex +1 372установок hyva-render-media-image hyva-themes Скилл hyva-render-media-image для Claude Code генерирует код адаптивных <picture> для шаблонов Hyvä Theme через view model Media. Формирует разные изображения для мобильных и десктопа. CX Codex +1 1 300установок planetscale-mcp-agent-operating-model planetscale Скилл planetscale-mcp-agent-operating-model задаёт правила безопасной работы ИИ-агентов с серверами PlanetScale MCP. Защищает продакшен от прямых изменений и направляет задачи через пулл-реквесты. CX Codex +1 2 800установок developer-kit-php Giuseppe Trisciuoglio Плагин developer-kit-php для Claude Code добавляет пять агентов, три скилла и правила кодинга для разработки на PHP, WordPress, Laravel и Symfony. ★ 372звёзд репо

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

Весь набор →
magento-issue-debugger Скилл magento-issue-debugger для Claude Code разбирает сбои Magento 2: воспроизводит проблему, собирает логи и помогает найти корневую причину. CX Codex +1 274установок magento-php-specialist Скилл magento-php-specialist для разработки под Magento 2 на PHP. Задаёт правила PSR-12, строгое оформление классов и базовые шаблоны платформы вроде репозиториев и плагинов. CX Codex +1 263установок magento-api-developer Скилл magento-api-developer помогает агенту проектировать и писать API для Magento 2: сервисные контракты, DTO, REST-контроллеры, GraphQL-резолверы и тесты. CX Codex +1 259установок magento-security-analyst Скилл magento-security-analyst разбирает безопасность магазина на Magento 2 по слоям и подсказывает, что закрыть: код, конфигурацию, зависимости, подготовку к PCI DSS и GDPR. CX Codex +1 212установок magento-feature-developer Скилл magento-feature-developer помогает проектировать и внедрять бизнес-функции для Magento 2: от сервисных контрактов и интеграций до тестов. Пригодится при создании модулей и расширении существующей функциональности. CX Codex +1 207установок magento-ui-component-developer Скилл magento-ui-component-developer для Claude Code создаёт сложные компоненты Magento UI Component: админские таблицы, формы, модальные окна и интерфейсы на данных. CX Codex +1 200установок magento-catalog-specialist Скилл magento-catalog-specialist помогает анализировать структуру каталога Magento 2, проверять состояние индексов, остатки на складах и атрибуты товаров. CX Codex +1 200установок magento-configuration-specialist Скилл magento-configuration-specialist разбирает системную конфигурацию Magento 2 по скоупам store, website и default, достаёт значения настроек и проверяет оплату, доставку и налоги. CX Codex +1 190установок

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

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