# magento-issue-debugger

Скилл magento-issue-debugger для Claude Code разбирает сбои Magento 2: воспроизводит проблему, собирает логи и помогает найти корневую причину.

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

## Что делает

Скилл ведёт разбор бага Magento 2 по одной схеме: воспроизвести проблему, зафиксировать окружение, оценить охват, найти момент, когда всё сломалось, и изолировать причину отключением модулей. Дальше он собирает данные — `var/log/exception.log` и `var/log/system.log`, ошибки PHP-FPM, логи веб-сервера, медленные запросы к БД.

Команды для проверки гипотез тоже прописаны: `bin/magento deploy:mode:set developer`, `cache:clean` и `cache:flush`, `indexer:reindex`, `setup:di:compile`, `setup:static-content:deploy`, `setup:db:status`. По ходу он смотрит свежие правки кода и состояние базы, а охват идёт от падений cron и прав доступа до ошибок REST и GraphQL.

Пошаговая отладка идёт через Xdebug, профилирование — через Blackfire, XHProf или New Relic. Без одного из этих инструментов в окружении разбор упрётся в логи, потому что заглянуть внутрь запроса будет нечем.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- найти причину, по которой падает оформление заказа
- разобрать ошибки индексации и кеша после деплоя
- прочитать exception.log и понять, откуда исключение
- вычислить узкое место в медленной карточке товара
- развести конфликт двух расширений, ломающих админку

## Примеры запросов агенту
- Разбери падение оформления заказа в Magento 2, вот `var/log/exception.log`
- Выясни, почему после деплоя не проходит `bin/magento indexer:reindex`
- Профилируй загрузку каталога и скажи, что тормозит

## Похожие
- [xdebug](https://affpapa.org/nevibecode/mcp/xdebug.md) — MCP-сервер · ★ 29 у репозитория
- [ddev-expert](https://affpapa.org/nevibecode/skills/ddev-expert.md) — скилл · 379 установок
- [hyva-create-module](https://affpapa.org/nevibecode/skills/hyva-create-module.md) — скилл · 1300 установок
- [hyva-cms-component](https://affpapa.org/nevibecode/skills/hyva-cms-component.md) — скилл · 786 установок
- [adk-debugger](https://affpapa.org/nevibecode/skills/adk-debugger.md) — скилл · 1700 установок
- [forge-debugger](https://affpapa.org/nevibecode/skills/forge-debugger.md) — скилл · 533 установки

Из того же набора: [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
