# refactor-specialist

Субагент refactor-specialist для Claude Code помогает безопасно менять структуру кода в нескольких файлах. Он подключается для переименования сущностей, переноса файлов и выделения модулей.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 267 у репозитория
- Автор: NYCU-Chung
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/NYCU-Chung/my-claude-devteam/tree/HEAD/agents/refactor-specialist.md
- Обновлён: 2026-04-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/refactor-specialist

## Что делает

refactor-specialist планирует крупный рефакторинг, находит все места использования сущности через `Grep` и составляет список изменений до правок. Затем обновляет файлы по одному, проверяет типы и запускает тесты на контрольных этапах. Подходит для задач, затрагивающих 10+ файлов.

В конце субагент проверяет линтер, полный набор тестов, сборку и изменённые пути вручную, а также просматривает diff. Рефакторинг отделяется от изменений поведения; при сбое работа останавливается до выяснения причины. Для небольшого изменения в одном-двух файлах предусмотрен другой субагент — `fullstack-engineer`.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add NYCU-Chung/my-claude-devteam
```
В чате агента (не в терминале):
```text
/plugin install devteam@my-claude-devteam
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/NYCU-Chung/my-claude-devteam/tree/HEAD/agents/refactor-specialist.md

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

## Примеры запросов агенту
- Переименуй `getUserById` во всём проекте в `findUser` без изменения поведения.
- Перенеси модуль и обнови все импорты, которые на него ссылаются.
- Выдели общую логику в новый модуль и проверь полный набор тестов.

## Похожие
- [refactor-guided](https://affpapa.org/nevibecode/commands/refactor-guided.md) — команда · ★ 1424 у репозитория
- [refactoring-specialist](https://affpapa.org/nevibecode/agents/refactoring-specialist.md) — субагент · 784 установки
- [code-refactor-review](https://affpapa.org/nevibecode/skills/code-refactor-review.md) — скилл · 181 установка
- [refactor](https://affpapa.org/nevibecode/skills/fradser-refactor.md) — скилл · 113 установок
- [refactor-method-complexity-reduce](https://affpapa.org/nevibecode/skills/refactor-method-complexity-reduce.md) — скилл · 9992 установки
- [w-refactor](https://affpapa.org/nevibecode/skills/w-refactor.md) — скилл · 647 установок

Из того же набора: [nycu-chung/my-claude-devteam](https://affpapa.org/nevibecode/by/nycu-chung/my-claude-devteam.md) — 13 карточек

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

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