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

magento-upgrade-specialist — скилл для Claude Code

Скилл magento-upgrade-specialist планирует апгрейды Magento 2, миграции с Magento 1 и проверку совместимости кода, расширений и базы данных.

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

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

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

Скилл разбирает текущую установку Magento, пользовательские модули, темы, изменения и сторонние расширения. Он помогает проверить целостность базы, сравнить производительность с исходным уровнем и найти проблемы совместимости через статический анализ, проверку API и deprecated-функций.

Дальше он помогает выбрать прямой или поэтапный путь обновления, подготовить среды разработки, staging и production, спланировать миграцию данных и откат. В процессе учитываются изменения схемы базы, конфигурации, Composer-зависимостей, расширений и frontend-кода. Для перехода с Magento 1.x на Magento 2.x отдельно рассматриваются перенос данных, тем и пользовательской логики.

В скилле есть команды для проверки версии и состояния базы, резервного копирования через mysqldump, обновления зависимостей Composer, запуска bin/magento setup:upgrade, компиляции, публикации статического контента, очистки кэша и переиндексации. При переходе с 2.3.x на 2.4.x нужно проверить совместимость версии PHP, потому что этот переход включает требования к PHP.

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

  • спланировать обновление Magento 2 между версиями
  • проверить совместимость модулей, тем и расширений
  • подготовить миграцию с Magento 1.x на Magento 2.x
  • найти breaking changes в API, конфигурации и схеме базы
  • составить план тестирования и отката

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

  • Проверь текущую установку Magento 2 и составь план перехода на целевую версию.
  • Оцени совместимость модулей и Composer-зависимостей перед обновлением.
  • Подготовь пошаговую миграцию с Magento 1.x на Magento 2.x с планом отката.

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

1Через Skills CLI (Vercel)

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

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

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

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

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

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

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

Выполните npx skills add maxnorm/magento2-agent-skills --skill magento-upgrade-specialist -a claude-code, затем проверьте файл ~/.claude/skills/magento-upgrade-specialist/SKILL.md.

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

Скилл анализирует Magento перед обновлением, проверяет совместимость кода и расширений, помогает спланировать миграцию и предлагает шаги для выполнения и тестирования апгрейда.

Что проверить перед переходом с Magento 2.3.x на 2.4.x?

Проверьте совместимость PHP, Composer-зависимостей и API. Также потребуется учесть изменения схемы базы, конфигурации и сторонних расширений.

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

SKILL.md · MIT
---
name: magento-upgrade-specialist
description: Manages seamless Magento 2 version upgrades and migrations. Use when upgrading Magento versions, migrating from Magento 1, planning upgrade strategies, assessing compatibility, or handling breaking changes. Masters upgrade planning, compatibility assessment, and post-upgrade optimization.
---

# Magento 2 Upgrade Specialist

Expert specialist in ensuring smooth, risk-free transitions between Magento versions while maintaining business continuity and preserving custom functionality.

## When to Use

- Upgrading Magento 2 versions (minor or major)
- Migrating from Magento 1.x to Magento 2.x
- Planning upgrade strategies and timelines
- Assessing extension compatibility
- Handling breaking changes
- Post-upgrade optimization

## Upgrade Process Framework

### 1. Pre-Upgrade Assessment
- **Current System Audit**: Comprehensive analysis of existing Magento installation
- **Custom Code Review**: Evaluate all custom modules, themes, and modifications
- **Extension Compatibility**: Check third-party extension compatibility with target version
- **Data Integrity Check**: Verify database consistency and identify potential issues
- **Performance Baseline**: Establish current performance metrics for comparison

### 2. Compatibility Analysis
- **Static Code Analysis**: Use automated tools to identify compatibility issues
- **API Change Review**: Analyze breaking changes in core APIs and interfaces
- **Deprecated Feature Assessment**: Identify and plan replacement for deprecated functionality
- **Database Schema Changes**: Review required database modifications
- **Configuration Changes**: Identify system configuration updates needed

### 3. Migration Planning
- **Upgrade Path Strategy**: Choose optimal upgrade path (direct vs. incremental)
- **Environment Setup**: Plan development, staging, and production upgrade environments
- **Downtime Minimization**: Develop strategies to reduce production downtime
- **Data Migration Strategy**: Plan for large dataset migrations and optimizations
- **Contingency Planning**: Prepare for various failure scenarios and recovery procedures

### 4. Implementation Execution
- **Code Migration**: Update custom code to work with target Magento version
- **Database Upgrade**: Execute database schema and data migrations
- **Configuration Migration**: Transfer and update system configurations
- **Extension Updates**: Upgrade or replace third-party extensions
- **Testing Validation**: Comprehensive testing of all upgraded functionality

## Upgrade Categories

### Minor Version Upgrades (2.4.x to 2.4.y)
- **Security Patches**: Apply critical security updates
- **Bug Fixes**: Resolve known issues and stability improvements
- **Feature Enhancements**: Leverage minor feature additions
- **Compatibility Updates**: Maintain extension and custom code compatibility
- **Performance Improvements**: Benefit from performance optimizations

### Major Version Upgrades (2.3.x to 2.4.x)
- **PHP Version Updates**: Handle PHP version compatibility requirements
- **Composer Dependencies**: Update package dependencies and constraints
- **API Changes**: Adapt to breaking changes in core APIs
- **New Architecture**: Leverage new architectural improvements
- **Migration Tools**: Utilize official migration utilities and scripts

### Legacy Migrations (Magento 1.x to 2.x)
- **Data Migration**: Comprehensive data structure transformation
- **Theme Migration**: Complete frontend redesign and implementation
- **Extension Replacement**: Find and implement Magento 2 equivalents
- **Custom Code Rewrite**: Rebuild custom functionality for Magento 2
- **Training Requirements**: Team training on Magento 2 architecture

## Upgrade Commands

### Pre-Upgrade
```bash
# Check current version
bin/magento --version

# Check database status
bin/magento setup:db:status

# Backup database
mysqldump -u user -p database > backup.sql

# Check extension compatibility
composer show | grep magento
```

### During Upgrade
```bash
# Update composer dependencies
composer require magento/product-community-edition:2.4.x --no-update
composer update

# Run upgrade
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush
bin/magento indexer:reindex
```

### Post-Upgrade
```bash
# Verify installation
bin/magento setup:db:status
bin/magento setup:upgrade

# Test functionality
# Run automated tests
# Manual testing checklist
```

## Common Upgrade Challenges

### Breaking Changes
- **API Changes**: Update code using deprecated APIs
- **Class Changes**: Update class references and namespaces
- **Configuration Changes**: Update XML configuration files
- **Database Schema**: Handle schema changes and migrations
- **Frontend Changes**: Update templates and layouts

### Extension Compatibility
- **Version Conflicts**: Resolve composer dependency conflicts
- **API Compatibility**: Update extensions using deprecated APIs
- **Replacement Extensions**: Find Magento 2 equivalents for incompatible extensions
- **Custom Patches**: Create patches for minor compatibility issues

### Data Migration
- **Schema Changes**: Handle database structure changes
- **Data Transformation**: Transform data to new formats
- **Custom Attributes**: Migrate custom EAV attributes
- **Media Files**: Migrate images and media files

## Best Practices

### Planning
- **Timeline Planning**: Create realistic upgrade schedules with proper testing phases
- **Risk Analysis**: Identify potential breaking changes and their business impact
- **Resource Planning**: Estimate effort, downtime, and team requirements
- **Rollback Strategy**: Plan comprehensive rollback procedures

### Execution
- **Environment Testing**: Test thoroughly in development and staging
- **Incremental Approach**: Consider incremental upgrades for major version changes
- **Documentation**: Document all changes and customizations
- **Communication**: Keep stakeholders informed throughout the process

### Post-Upgrade
- **Performance Validation**: Ensure performance meets or exceeds baseline
- **Functionality Testing**: Comprehensive testing of all features
- **Security Review**: Verify security improvements are properly implemented
- **Monitoring**: Monitor system health and performance post-upgrade

## Testing Strategy

- **Unit Tests**: Run and update unit tests
- **Integration Tests**: Test module integration with core
- **Functional Tests**: End-to-end test scenarios
- **Performance Tests**: Validate performance under load
- **Security Tests**: Verify security compliance

## References

- [Adobe Commerce Upgrade Guide](https://developer.adobe.com/commerce/operate/upgrade/)
- [Release Notes](https://devdocs.magento.com/guides/v2.4/release-notes/)
- [Migration Guide](https://developer.adobe.com/commerce/php/development/migration/)

Focus on smooth, risk-free upgrades that maintain business continuity while leveraging new Magento capabilities.

© 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установок php-mcp-server-generator официальный github Скилл php-mcp-server-generator для GitHub Copilot генерирует PHP-проект MCP-сервера с инструментами, ресурсами, промптами и тестами. Собирает основу сервера под свои задачи. CX Codex +1 8 900установок wp-phpstan WordPress Скилл wp-phpstan настраивает статический анализ PHPStan в плагинах и темах WordPress, генерирует бейзлайн и помогает типизировать хуки с REST-запросами. CX Codex +1 5 300установок php-development Mindrally Скилл php-development для Claude Code, Codex, Cursor и других агентов, который задаёт стиль PHP 8+ с типизацией, PSR-12 и SOLID. Генерирует код с declare(strict_types=1), PHPDoc-блоками и prepared statements. CX Codex +1 1 100установок php-expert personamanagmentlayer Скилл php-expert для Claude Code задаёт агенту правила работы с PHP 8+, Laravel, Composer и PHPUnit. Охватывает разработку, тестирование и ревью современного PHP-кода. CX Codex +1 269установок typo3cms-extension-cursorrules-prompt-file PatrickJS Правило typo3cms-extension-cursorrules-prompt-file для Cursor, которое задаёт структуру и стандарты для разработки расширений TYPO3 CMS. Направляет агент при создании PHP-кода, конфигурации и тестов. CX Codex +1 ★ 41 178звёзд репо

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

Весь набор →
magento-configuration-specialist Скилл magento-configuration-specialist разбирает системную конфигурацию Magento 2 по скоупам store, website и default, достаёт значения настроек и проверяет оплату, доставку и налоги. CX Codex +1 190установок magento-order-specialist Скилл magento-order-specialist для Claude Code разбирает заказы и их обработку в Magento 2: платежи, статусы, доставку и возвраты. Ищет сбои и узкие места. CX Codex +1 184установок magento-index-analyst Скилл magento-index-analyst для Claude Code разбирает индексацию Magento 2: переиндексацию, настройку Elasticsearch и индексы в базе. Разбирает медленную работу каталога и поиска. CX Codex +1 179установок magento-deployment-engineer Скилл magento-deployment-engineer проектирует CI/CD и автоматические деплои для Magento 2. Он пригодится при настройке инфраструктуры, контейнеризации и DevOps-процессов. CX Codex +1 176установок magento-knockout-specialist Скилл magento-knockout-specialist помогает писать реактивные фронтенд-компоненты на KnockoutJS для Magento 2 с учётом архитектуры MVVM. CX Codex +1 168установок magento-environment-engineer Скилл magento-environment-engineer для Claude Code настраивает и сопровождает окружения Magento 2: development, staging, production и testing. Помогает конфигурировать сервер и искать проблемы. CX Codex +1 168установок magento-css-specialist Скилл magento-css-specialist помогает разрабатывать CSS и LESS для тем Magento 2: от адаптивной вёрстки до структуры компонентов и оптимизации загрузки стилей. CX Codex +1 167установок magento-alpine-specialist Скилл magento-alpine-specialist для Claude Code задаёт агенту правила создания реактивных компонентов Alpine.js для витрин Magento 2 и тем Hyvä. Добавляет шаблонам поведение без отдельного JS-фреймворка. CX Codex +1 166установок

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

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