# refactoring-expert

Субагент refactoring-expert для Claude Code ищет запахи кода и пошагово рефакторит без изменения внешнего поведения. Разбирает дублирование, длинные методы и сложные условия.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 763 у репозитория
- Автор: carlrannaberg
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/carlrannaberg/claudekit/tree/HEAD/src/agents/refactoring/refactoring-expert.md
- Обновлён: 2026-03-31
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/carlrannaberg-refactoring-expert

## Что делает

refactoring-expert анализирует структуру проекта, выявляет запахи кода и выбирает подходящий приём рефакторинга. Он работает с файлами через `Read`, `Grep`, `Glob`, `Edit`, `MultiEdit` и `Bash`, а перед изменениями проверяет настройки проекта и тестовый стек.

Субагент предлагает небольшие изменения: выделение методов и переменных, перенос логики между объектами, упрощение условий, замену магических чисел и группировку параметров. После каждого шага он запускает тесты, проверяет линтинг и сверяет, что поведение не изменилось. Без тестов рефакторинг сначала потребует создать их.

Внутри есть проверки для JavaScript и TypeScript: поиск длинных методов, цепочек вызовов, глубокой вложенности, дублирования и длинных списков параметров. Для узкой задачи он может перенаправить работу к специализированному субагенту.

## Установка

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

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/carlrannaberg/claudekit/tree/HEAD/src/agents/refactoring/refactoring-expert.md

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

## Примеры запросов агенту
- Найди запахи кода в текущем проекте и исправь их по одному, сохраняя внешнее поведение.
- Разбери этот длинный метод: предложи безопасные шаги рефакторинга, добавь тесты при необходимости и проверь линтинг.
- Упрости вложенные условия и длинные списки параметров в `src/`, затем запусти тесты.

## Похожие
- [refactoring-analysis](https://affpapa.org/nevibecode/skills/refactoring-analysis.md) — скилл · 434 установки
- [refactoring-surgeon](https://affpapa.org/nevibecode/skills/refactoring-surgeon.md) — скилл · 260 установок
- [refactoring-specialist](https://affpapa.org/nevibecode/agents/coco-research-refactoring-specialist.md) — субагент · ★ 328 у репозитория
- [dry-refactoring](https://affpapa.org/nevibecode/skills/dry-refactoring.md) — скилл · 4100 установок
- [refactor](https://affpapa.org/nevibecode/skills/luongnv89-refactor.md) — скилл · ★ 47494 у репозитория
- [jscodeshift](https://affpapa.org/nevibecode/skills/jscodeshift.md) — скилл · 422 установки

## Другие версии с тем же именем
- [refactoring-expert · superclaude-org](https://affpapa.org/nevibecode/agents/refactoring-expert.md) — ★ 23950 у репозитория

Из того же набора: [carlrannaberg/claudekit](https://affpapa.org/nevibecode/by/carlrannaberg/claudekit.md) — 54 карточки

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

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