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

magento-php-specialist — скилл для Claude Code: обзор и установка

Скилл magento-php-specialist для разработки под Magento 2 на PHP. Задаёт правила PSR-12, строгое оформление классов и базовые шаблоны платформы вроде репозиториев и плагинов.

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

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

Что делает magento-php-specialist

Скилл инструктирует агента генерировать PHP-код по стандартам PSR-12 и Magento2 Coding Standard из vendor/magento/magento-coding-standard/Magento2. Во всех файлах требуется объявление declare(strict_types=1);, фигурные скобки классов и методов на отдельной строке, а также строгое сравнение через === и !==. Любые нестрогие проверки запрещены.

В правилах зафиксированы современные элементы языка: match-выражения вместо switch, union types и продвижение свойств в конструкторе с модификатором readonly. Скилл ориентирует архитектуру на композицию вместо наследования, сервисные контракты, фабрики и обсерверы. Для логирования задан интерфейс \Psr\Log\LoggerInterface.

Любое обращение к сервис-локаторам нарушает эти правила: скилл допускает только прямое внедрение зависимостей через конструктор.

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

  • написать сервис для Magento 2 со строгой типизацией PHP
  • оформить внедрение зависимостей через конструктор без сервис-локатора
  • реализовать паттерн репозитория или сервисный контракт по PSR-12
  • заменить конструкции switch на match-выражения

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

  • Создай класс сервиса в модуле каталога с внедрением репозитория через конструктор
  • Реализуй плагин для перехвата вызовов репозитория заказов с объявлением строгой типизации
  • Перепиши бизнес-логику расчёта скидки с использованием match-выражений и union types

Как установить magento-php-specialist

1Через Skills CLI (Vercel)

npx skills add maxnorm/magento2-agent-skills --skill magento-php-specialist -a claude-code

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

~/.claude/skills/magento-php-specialist/SKILL.md

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

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

Вопросы о magento-php-specialist

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

Выполните команду npx skills add maxnorm/magento2-agent-skills --skill magento-php-specialist -a claude-code. Либо сохраните файл вручную по пути ~/.claude/skills/magento-php-specialist/SKILL.md.

Что делает magento-php-specialist?

Настраивает агента на разработку модулей Magento 2 по стандартам PSR-12 с обязательной строгой типизацией и документированием параметров в PHPDoc.

Как скилл требует внедрять зависимости?

Он предписывает внедрение зависимостей исключительно через параметры конструктора и запрещает вызов сервис-локаторов.

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

SKILL.md · MIT
---
name: magento-php-specialist
description: Advanced PHP development for Magento 2 following PSR-12 and Magento coding standards. Use when writing PHP code, implementing business logic, or ensuring code quality. Masters modern PHP features, object-oriented programming, design patterns, and Magento-specific PHP practices.
---

# Magento 2 PHP Specialist

Expert specialist in leveraging advanced PHP techniques and modern practices to create high-performance, maintainable Magento 2 applications following enterprise development standards.

## When to Use

- Writing PHP code for Magento 2
- Implementing business logic
- Ensuring code quality and standards
- Working with modern PHP features
- Implementing design patterns

## PHP Standards (STRICT ENFORCEMENT)

### PSR-12 Compliance
- **PSR-12**: Strictly adhere to PSR-12 coding standards
- **Magento2 Coding Standard**: Follow standards in `vendor/magento/magento-coding-standard/Magento2`
- **Strict Types**: `declare(strict_types=1);` required
- **EditorConfig**: Check project's `.editorconfig` for indentation (4 spaces), line endings (LF), encoding (UTF-8)

### Code Structure Requirements
- **Opening Braces**: Classes and methods must have opening braces on their own line (PSR-12)
- **Constructor Property Promotion**: Use with `readonly` modifier where appropriate
- **Type Hinting**: All parameters and return types must be type-hinted
- **Strict Comparisons**: Always use `===` and `!==` (never `==` or `!=`)
- **Constructor PHPDoc**: Must include `@param` annotation for each parameter

### Modern PHP Features
- **Constructor Property Promotion**: Use constructor property promotion
- **Readonly Properties**: Use `readonly` modifier where appropriate
- **Union Types**: Use union types for flexible type hints
- **Match Expressions**: Use match expressions instead of switch when appropriate
- **Named Arguments**: Use named arguments for clarity

### Code Example
```php
<?php

/**
 * Copyright © 2025 CompanyName. All rights reserved.
 */

declare(strict_types=1);

namespace CompanyName\ModuleName\Model;

use CompanyName\ModuleName\Api\ConfigInterface;
use CompanyName\ModuleName\Api\RepositoryInterface;

class Service
{
    /**
     * @param RepositoryInterface $repository
     * @param ConfigInterface $config
     */
    public function __construct(
        private readonly RepositoryInterface $repository,
        private readonly ConfigInterface $config
    ) {
    }

    /**
     * @param int $id
     * @return EntityInterface|null
     */
    public function getById(int $id): ?EntityInterface
    {
        if ($id <= 0) {
            return null;
        }

        return $this->repository->getById($id);
    }
}
```

## Best Practices

### Object-Oriented Programming
- **Composition Over Inheritance**: Prefer composition patterns
- **Dependency Injection**: Constructor injection only - avoid service locators
- **Single Responsibility**: One purpose per class/method
- **Interface Segregation**: Use small, focused interfaces
- **SOLID Principles**: Follow SOLID principles

### Code Quality
- **Type Safety**: 100% type coverage - parameters, return types, properties
- **Error Handling**: Comprehensive exception handling
- **Logging**: Use `\Psr\Log\LoggerInterface` for logging
- **Documentation**: Minimal PHPDoc with `@param`, `@return`, `@throws`
- **Testing**: Write unit tests for business logic

### Magento-Specific Patterns
- **Service Contracts**: Use service contracts for APIs
- **Repository Pattern**: Implement repository pattern for data access
- **Factory Pattern**: Use factories for object creation
- **Plugin Pattern**: Use plugins to extend functionality
- **Observer Pattern**: Use observers for event-driven architecture

## References

- [PSR-12 Coding Standard](https://www.php-fig.org/psr/psr-12/)
- [Adobe Commerce PHP Development](https://developer.adobe.com/commerce/php/development/)
- [Coding Standards](https://developer.adobe.com/commerce/php/coding-standards/)

Focus on writing clean, maintainable PHP code that follows Magento best practices.

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

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

Все скиллы по теме «Бэкенд и API» →
php-pro davila7 Скилл php-pro для Claude Code помогает писать идиоматичный PHP с типизацией, ООП и упором на производительность. Помогает обрабатывать большие наборы данных и разбирать узкие места. CX Codex +1 228установок php sanjeed5 Правило php для Cursor задаёт соглашения по стилю и безопасности PHP-кода. Оно применяется ко всем файлам и охватывает типизацию, обработку ошибок, тесты и API. CX Codex +1 ★ 3 589звёзд репо spatie-laravel-php Spatie Скилл spatie-laravel-php настраивает правила кодинга Spatie и PSR-12 для задач по созданию, рефакторингу и ревью PHP-кода или шаблонов Blade в проектах на Laravel. CX Codex +1 1 400установок laravel-development Mindrally Скилл laravel-development для Claude Code задаёт агенту рамки Laravel-разработки: SOLID, PSR-12, Eloquent вместо сырого SQL. Описывает, как агент пишет PHP-код в Laravel-проекте. CX Codex +1 965установок plasticode-telegram-api-cursorrules-prompt-file PatrickJS Правило plasticode-telegram-api-cursorrules-prompt-file для Cursor задаёт стиль ответов по PHP 7.4, Plasticode и Telegram Bot API: коротко, технически и с примерами кода. Учитывает SOLID и PSR-12. CX Codex +1 ★ 41 178звёзд репо php-best-practices php-community Скилл php-best-practices для Claude Code содержит 51 правило проверки PHP 8.0–8.5 по PSR, SOLID и строгой типизации. Используется при код-ревью и рефакторинге классов. CX Codex +1 3 900установок

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

Весь набор →
magento-performance-analyst Скилл magento-performance-analyst ведёт агента по профилированию Magento 2: ищет узкие места, разбирает медленные запросы и планирует оптимизации. CX Codex +1 449установок magento-frontend-developer Скилл magento-frontend-developer задаёт правила вёрстки и клиентской разработки под Magento 2: от макетов layout XML и шаблонов PHTML до скриптов на KnockoutJS и оптимизации Core Web Vitals. CX Codex +1 420установок magento-xml-specialist Скилл magento-xml-specialist для ИИ-агента, который пишет и проверяет XML-конфигурации Magento 2: layout, di.xml, system.xml, module.xml и db_schema.xml. CX Codex +1 394установок magento-issue-debugger Скилл magento-issue-debugger для Claude Code разбирает сбои Magento 2: воспроизводит проблему, собирает логи и помогает найти корневую причину. CX Codex +1 274установок 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-model-developer Скилл magento-model-developer помогает проектировать слой данных в Magento 2: строить модели, декларативные схемы db_schema.xml, репозитории и коллекции под EAV или плоские таблицы. CX Codex +1 210установок magento-feature-developer Скилл magento-feature-developer помогает проектировать и внедрять бизнес-функции для Magento 2: от сервисных контрактов и интеграций до тестов. Пригодится при создании модулей и расширении существующей функциональности. CX Codex +1 207установок

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

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