# php-refactor-expert

Субагент php-refactor-expert разбирает PHP-код и предлагает рефакторинг с сохранением поведения. Запускайте его после реализации функции или когда код трудно читать и поддерживать.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 372 у репозитория
- Автор: Giuseppe Trisciuoglio
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-php/agents/php-refactor-expert.md
- Обновлён: 2026-09-10
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/php-refactor-expert

## Что делает

Субагент проверяет стандарты проекта в `CLAUDE.md` или `composer.json`, затем ищет проблемные места в целевых файлах и проводит изменения поэтапно. Он ориентируется на PHP 8.3+, Laravel и Symfony, применяет принципы SOLID и проверяет результат тестами.

В его чек-листе — типы, свойства `readonly`, перечисления, PSR-12, именование, упрощение условий и удаление мёртвого кода. Среди примеров рефакторинга есть замена вложенных условий ранними выходами, выделение вспомогательных методов и перенос значений в конфигурацию. Для PHP ниже 8.3 заявленные рекомендации по версии языка не подойдут.

Субагенту доступны чтение и изменение файлов, поиск по проекту и запуск команд через `Bash`. Он также использует скилл `clean-architecture`; тесты нужно запускать при проверке изменений.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
```
В чате агента (не в терминале):
```text
/plugin install developer-kit-php@developer-kit
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/php-refactor-expert.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/php-refactor-expert.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/php-refactor-expert.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-php/agents/php-refactor-expert.md

## Когда брать
- упростить вложенные условия в PHP-методе
- разбить сложный расчёт на отдельные методы
- заменить создание зависимостей внутри контроллера внедрением через контейнер
- вынести числа и строки из кода в конфигурацию
- удалить мёртвый код и обновить тесты после рефакторинга

## Примеры запросов агенту
- Проверь этот PHP-код на проблемные места и предложи рефакторинг без изменения поведения.
- Разбей сложный расчёт в этом классе на методы с понятными именами.
- Замени создание сервисов внутри контроллера внедрением зависимостей и проверь изменения тестами.

## Похожие
- [php-pro](https://affpapa.org/nevibecode/agents/voltagent-community-php-pro.md) — субагент · 2019 установок
- [appwrite-php](https://affpapa.org/nevibecode/skills/appwrite-php.md) — скилл · 898 установок
- [php-expert](https://affpapa.org/nevibecode/skills/php-expert.md) — скилл · 269 установок
- [sentry-php-sdk](https://affpapa.org/nevibecode/skills/sentry-php-sdk.md) — скилл · 2400 установок
- [spatie-laravel-php](https://affpapa.org/nevibecode/skills/spatie-laravel-php.md) — скилл · 1400 установок
- [laravel-php-83-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/laravel-php-83-cursorrules-prompt-file.md) — правило · ★ 41178 у репозитория

Из того же набора: [giuseppe-trisciuoglio/developer-kit](https://affpapa.org/nevibecode/by/giuseppe-trisciuoglio/developer-kit.md) — 191 карточка

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

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