# general-refactor-expert

Субагент general-refactor-expert для планомерного рефакторинга кодовой базы без потери функциональности. Находит запахи кода, дробит длинные функции и перестраивает архитектуру по SOLID.

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

## Что делает

Субагент анализирует файлы проекта с помощью встроенных инструментов чтения, поиска и терминала (`Read`, `Write`, `Edit`, `Glob`, `Grep`, `Bash`). Он ориентирован на модель `sonnet` и работает по четырём фазам: оценка текущего состояния с замером тестового покрытия, выработка стратегии с учётом рисков, пошаговое изменение кода и валидация через запуск существующих тестов.

В фокусе субагента типичные проблемы структуры: слишком длинные методы (рекомендует удерживать их объём в пределах 20 строк и не более 3 параметров), раздутые классы, дублирование логики, паразитные цепочки вызовов и «магические числа». Итогом работы становится структурированный отчёт с разбором рисков, примерами до и после правок, планом фаз и списком обновлений для тестов.

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

## Установка

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

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

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

### Codex

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

### Cursor

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

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

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

## Примеры запросов агенту
- Проверь модуль auth.py через субагента general-refactor-expert и составь план рефакторинга
- Используй general-refactor-expert, чтобы устранить дублирование в обработчиках заказов
- Запусти general-refactor-expert для файла payment_service.ts и разбей класс по принципам SOLID

## Похожие
- [clean-code-guard](https://affpapa.org/nevibecode/skills/clean-code-guard.md) — скилл · 4900 установок
- [safe-refactor](https://affpapa.org/nevibecode/skills/safe-refactor.md) — скилл · 130700 установок
- [solid](https://affpapa.org/nevibecode/skills/solid.md) — скилл · 3700 установок
- [clean-code-principles](https://affpapa.org/nevibecode/skills/clean-code-principles.md) — скилл · 1900 установок
- [code-quality](https://affpapa.org/nevibecode/skills/miles990-code-quality.md) — скилл · 786 установок
- [WG Code Alchemist](https://affpapa.org/nevibecode/agents/wg-code-alchemist.md) — субагент · ★ 41430 у репозитория

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