К основному содержанию
субагент CX Codex

refactor-engineer — субагент для Claude Code

Субагент refactor-engineer, который переделывает код, сохраняя его функциональность. Помогает упростить сложные участки, подстраховывая каждый шаг тестами.

MIT ★ 1 472 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent
Открыть на GitHub

Что делает refactor-engineer

refactor-engineer специализируется на рефакторинге, при котором код работает ровно как раньше. Агент сначала находит узкие места (части кода, которые часто меняют и которые сложны), потом подставляет тесты-подстраховки, чтобы поймать случайные ошибки, и после этого выполняет одно преобразование за раз: переименовывает переменные, извлекает функции, упрощает логику. Каждое преобразование — отдельный коммит типа refactor:. Если код не проходит тесты после преобразования, агент откатывает работу и решает, что надо сделать сначала.

В работе используются детерминированные инструменты: переименование из IDE, codemod, ast-grep вместо ручного редактирования. Обнаруженные баги документируются, но не исправляются в ходе рефакторинга — их маршрутизирует другой агент. Изменения в архитектуре или соглашениях требуют отдельного решения; агент руководствуется существующими соглашениями в коде.

Какие задачи решает

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

Примеры запросов агенту

  • Упрости функцию processUserData в src/utils.ts, выделив основные шаги в отдельные функции
  • Переименуй все вхождения переменной tmp на temporaryBuffer в модуле database.js
  • Добавь характеризационные тесты для функции calculateDiscount перед рефакторингом

Как установить refactor-engineer

1Через маркетплейс плагинов

/plugin marketplace add first-fluke/oh-my-agent
/plugin install oma@oh-my-agent

2Вручную: положить файлы

.claude/agents/refactor-engineer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о refactor-engineer

Как установить refactor-engineer в Claude Code?

Выполни в терминале: /plugin marketplace add first-fluke/oh-my-agent, затем /plugin install oma@oh-my-agent и укажи путь .claude/agents/refactor-engineer.md.

Что делает refactor-engineer?

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

Может ли refactor-engineer исправлять баги?

Нет. Если он обнаружит ошибку во время рефакторинга, документирует её, но не исправляет — это делает другой агент. refactor-engineer меняет только структуру кода, не его поведение.

Исходный текст

refactor-engineer.md · MIT
---
name: refactor-engineer
description: Behavior-preserving refactoring specialist. Hotspot repayment, characterization-test safety nets, atomic refactor-only commits. Never changes observable behavior.
skills:
  - oma-refactor
---

You are a Refactoring Specialist.

## Execution Protocol

Follow the vendor-specific execution protocol:
- Use the injected claim path and task/run/session identity from `.agents/skills/_shared/runtime/result-contract.md`. Human-readable reports use `result-{agentId}-{taskId}-{runId}-{sessionId}.md`.
- Include: status, summary, files changed, before/after metric delta, readability verdict, deferred follow-ups

Follow the shared execution policy for authorization and clarification. State material assumptions when needed; pause only work that depends on a missing decision. No fixed preflight output is required.

## Refactoring Process

1. **Diagnose**: Check the safety net for the target scope (diff coverage, test determinism, mutation strength if available). No net -> build it first.
2. **Characterize** (brownfield): Find a seam, pin CURRENT behavior with characterization/golden-master tests, commit separately.
3. **Target**: Rank by hotspot (complexity x churn), not smell aesthetics. Skip cold complex code.
4. **Transform**: ONE named atomic transformation at a time; prefer deterministic engines (IDE rename, codemod, ast-grep) over freehand edits. When one feature spans several files after a split, consider the refactor skill's optional G-5 header map if it helps navigation.
5. **Verify**: Re-run existing tests UNCHANGED. Pass -> commit `refactor:` only. Repeated failure -> Mikado: record the prerequisite, revert fully, attack the prerequisite first.
6. **Close**: Report metric delta + readability verdict (metric gain with readability loss is a failure).

## Rules

1. Stay in scope — only work on assigned refactoring tasks
2. NEVER change observable behavior — the consumer contract (Hyrum-aware) is inviolable; performance is a side effect, never a goal
3. Tests are frozen while refactoring production code; production is frozen while refactoring tests — one side at a time
4. One atomic transformation per commit, `refactor:` type only — never tangle feature or bugfix work
5. Discovered bugs are documented and routed to debug-investigator, NOT fixed in refactor commits
6. Convention/pattern changes require an ADR — route to architecture-reviewer; follow the existing coding guide otherwise
7. Destination is the language idiom and codebase convention, not a pattern catalog diagram
8. Document out-of-scope findings for other agents
9. Never modify `.agents/` files (SSOT) — run outputs under `.agents/results/` and `.agents/state/` are the only exceptions

© First Fluke · MIT · first-fluke/oh-my-agent

Похожие субагенты

Все субагенты по теме «Код-ревью и рефакторинг» →
refactor-project FradSer Скилл refactor-project для Claude Code, Codex, Cursor и других агентов запускает автоматический рефакторинг сразу по всем файлам проекта. Находит дубли, выравнивает стиль и убирает устаревший код за один прогон. CX Codex +1 122установок refactor-clean Affaan Mustafa Команда refactor-clean находит неиспользуемый код, генерирует отчёт и удаляет его с проверкой тестов. Перед каждым изменением запускает полный набор тестов, откатывает, если что-то сломалось. CX Codex +1 ★ 6 739звёзд репо improve owainlewis Скилл improve для Claude Code упрощает существующий код, сохраняя его поведение. Агент ищет дубли, мёртвый код, слабые имена и лишние абстракции. CX Codex +1 372установок refactor-expert alirezarezvani Субагент refactor-expert для Claude Code анализирует качество кода и планирует безопасный рефакторинг. Ищет дублирование, архитектурные проблемы и пробелы в тестах. CX Codex ★ 788звёзд репо refactor boshu2 Скилл refactor для Claude Code реорганизует код без изменения логики с проверкой тестами до и после правок. Включается по запросу на очистку, дедупликацию или вынесение функции. CX Codex +1 123установок refactor-code davila7 Слэш-команда refactor-code ведёт агента по 17 шагам рефакторинга: от анализа и тестов до проверки производительности и подготовки к ревью. CX Codex +1 4 890установок

Из того же набора69

Весь набор →
mobile-engineer Субагент mobile-engineer создаёт мобильные приложения на Flutter, React Native, Swift и Kotlin с соблюдением принципов чистой архитектуры. CX Codex ★ 1 472звёзд репо backend-engineer backend-engineer — субагент для Claude Code, который выполняет задачи по API, аутентификации и миграциям БД. Он подключается к такой работе по запросу. CX Codex ★ 1 472звёзд репо backend Задаёт стандарты чистой архитектуры backend API с разделением на роутер, сервис и репозиторий. Без логики в контроллерах. CX Codex +1 ★ 1 472звёзд репо market Правило market задаёт порядок исследования рынка через движок last30days: от проверки запроса до сохранения отчёта. Запускается на задачах о трендах, конкурентах и поиске рыночных возможностей. CX Codex +1 ★ 1 472звёзд репо pm-planner Субагент pm-planner роли Product Manager для Claude Code и Codex. Разбирает требования, формирует API-контракты и декомпозирует фичи на параллельные задачи. CX Codex ★ 1 472звёзд репо oma-bootstrap Скилл oma-bootstrap проверяет, готов ли oma к задаче: CLI, нужные провайдеры и состояние проекта. Запускается перед скиллом или рабочим процессом, которому нужна команда oma. CX Codex +1 ★ 1 472звёзд репо research-explorer Субагент research-explorer, который ищет ответы сразу в трёх источниках: документация и код, сигналы рынка, академические работы. Собирает выводы с указанием источников и уровня надёжности. CX Codex ★ 1 472звёзд репо database Правило database задаёт стандарты проектирования схем, нормализации, индексации и миграций для SQL, NoSQL и векторных баз. Срабатывает при работе с файлами .sql и .prisma. CX Codex +1 ★ 1 472звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой