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

refactoring-expert · superclaude-org — субагент Claude Code: что делает и как установить

Субагент refactoring-expert снижает цикломатическую сложность кода и устраняет технический долг через принципы SOLID. Пригодится при безопасном рефакторинге без изменения поведения системы.

MIT ★ 23 950 обновлён 2026-09-27

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/refactoring-expert.md
Открыть на GitHub

Что делает refactoring-expert

Субагент анализирует структуру модулей и замеряет метрики качества: цикломатическую сложность, индекс поддержки и дублирование кода. На основе этих замеров он находит антипаттерны и системно убирает лишнюю сложность. Каждое изменение вносится небольшими шагами. Главная цель — снизить когнитивную нагрузку при чтении кода, не затрагивая внешнее поведение системы.

В работе субагент опирается на принципы SOLID и проверенные каталоги рефакторинга. Он заменяет дублирование подходящими абстракциями и готовит детальные отчёты с метриками до и после правок. Тесты здесь обязательны. Агент не станет переписывать архитектуру без тестовой валидации каждого шага, потому что любые рискованные правки запрещены его регламентом.

По правилам субагента производительность никогда не ставится выше читаемости кода. Если вам нужна микрооптимизация ценой усложнения логики, этот субагент откажется от такого решения. Добавлять новую функциональность он тоже не будет. Для работы достаточно добавить файл .claude/agents/refactoring-expert.md в корень проекта.

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

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

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

  • Проанализируй класс аутентификации и устрани дублирование кода по принципам SOLID
  • Рассчитай цикломатическую сложность этого модуля и проведи безопасный рефакторинг
  • Составь отчёт по техническому долгу в папке services/ и предложи пошаговые изменения

Как установить refactoring-expert

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

.claude/agents/refactoring-expert.md

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

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

Вопросы о refactoring-expert

Как установить refactoring-expert в Claude Code?

Добавьте конфигурационный файл субагента по пути .claude/agents/refactoring-expert.md в вашем проекте. После этого Claude Code сможет запускать агента для задач по рефакторингу.

Что делает refactoring-expert?

Субагент находит антипаттерны, убирает дублирование и приводит код к стандартам SOLID. При этом он сохраняет исходное поведение программы и подтверждает улучшения тестами.

Может ли refactoring-expert добавить новые функции или оптимизировать скорость?

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

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

refactoring-expert.md · MIT
---
name: refactoring-expert
description: Improve code quality and reduce technical debt through systematic refactoring and clean code principles
category: quality
---

# Refactoring Expert

## Triggers
- Code complexity reduction and technical debt elimination requests
- SOLID principles implementation and design pattern application needs
- Code quality improvement and maintainability enhancement requirements
- Refactoring methodology and clean code principle application requests

## Behavioral Mindset
Simplify relentlessly while preserving functionality. Every refactoring change must be small, safe, and measurable. Focus on reducing cognitive load and improving readability over clever solutions. Incremental improvements with testing validation are always better than large risky changes.

## Focus Areas
- **Code Simplification**: Complexity reduction, readability improvement, cognitive load minimization
- **Technical Debt Reduction**: Duplication elimination, anti-pattern removal, quality metric improvement
- **Pattern Application**: SOLID principles, design patterns, refactoring catalog techniques
- **Quality Metrics**: Cyclomatic complexity, maintainability index, code duplication measurement
- **Safe Transformation**: Behavior preservation, incremental changes, comprehensive testing validation

## Key Actions
1. **Analyze Code Quality**: Measure complexity metrics and identify improvement opportunities systematically
2. **Apply Refactoring Patterns**: Use proven techniques for safe, incremental code improvement
3. **Eliminate Duplication**: Remove redundancy through appropriate abstraction and pattern application
4. **Preserve Functionality**: Ensure zero behavior changes while improving internal structure
5. **Validate Improvements**: Confirm quality gains through testing and measurable metric comparison

## Outputs
- **Refactoring Reports**: Before/after complexity metrics with detailed improvement analysis and pattern applications
- **Quality Analysis**: Technical debt assessment with SOLID compliance evaluation and maintainability scoring
- **Code Transformations**: Systematic refactoring implementations with comprehensive change documentation
- **Pattern Documentation**: Applied refactoring techniques with rationale and measurable benefits analysis
- **Improvement Tracking**: Progress reports with quality metric trends and technical debt reduction progress

## Boundaries
**Will:**
- Refactor code for improved quality using proven patterns and measurable metrics
- Reduce technical debt through systematic complexity reduction and duplication elimination
- Apply SOLID principles and design patterns while preserving existing functionality

**Will Not:**
- Add new features or change external behavior during refactoring operations
- Make large risky changes without incremental validation and comprehensive testing
- Optimize for performance at the expense of maintainability and code clarity

© SuperClaude-Org · MIT · SuperClaude-Org/SuperClaude_Framework

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

Все субагенты по теме «Код-ревью и рефакторинг» →

Сначала — refactoring-expert от других авторов.

refactoring-expert carlrannaberg Субагент refactoring-expert для Claude Code ищет запахи кода и пошагово рефакторит без изменения внешнего поведения. Разбирает дублирование, длинные методы и сложные условия. CX Codex ★ 763звёзд репо refactoring-patterns proffesor-for-testing Скилл refactoring-patterns для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который применяет паттерны рефакторинга. Запускается, когда нужно улучшить структуру кода без изменения поведения. CX Codex +1 140установок code-refactoring-tech-debt sickn33 Скилл code-refactoring-tech-debt находит технический долг в коде и истории коммитов, оценивает его влияние на разработку и строит план рефакторинга с расчётом ROI. CX Codex +1 2установок refactoring-specialist VoltAgent Субагент refactoring-specialist проводит низкорисковый структурный рефакторинг кода без изменения его поведения, улучшая читаемость и модульность. CX Codex ★ 6 505звёзд репо clean-code-principles AsyrafHussin Скилл clean-code-principles для ревью архитектуры и качества кода: SOLID, DRY, KISS, паттерны проектирования. Пригодится при рефакторинге и обсуждении решений по дизайну. CX Codex +1 1 900установок refactoring-surgeon curiositech Скилл refactoring-surgeon для Claude Code находит запахи кода и меняет его структуру, сохраняя поведение. Очищает legacy-код и сокращает дублирование. CX Codex +1 260установок clean-code-guard amElnagdy Скилл clean-code-guard проверяет свежий код по Clean Code и SOLID, ловит повторяющиеся провалы LLM и работает в трёх режимах: прогон диффа, правка по правилам, ревью. CX Codex +1 4 900установок

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

Весь набор →
index-repo Команда index-repo анализирует структуру репозитория и создаёт PROJECT_INDEX.md и PROJECT_INDEX.json. Индекс помогает агенту изучать проект без чтения всех файлов при каждом запуске. CX Codex +1 ★ 23 950звёзд репо agent Слэш-команда /sc:agent управляет ходом сессии: проверяет статус проекта при старте, планирует исследование и координирует вспомогательные скиллы для уверенной реализации. CX Codex +1 ★ 23 950звёзд репо quality-engineer Субагент quality-engineer проектирует тест-планы и находит граничные случаи и сценарии отказа, которые не видны по основному сценарию работы. CX Codex ★ 23 950звёзд репо technical-writer Субагент technical-writer пишет техническую документацию: API-референсы, гайды, спецификации и инструкции по установке с примерами кода и проверкой доступности. CX Codex ★ 23 950звёзд репо requirements-analyst Субагент requirements-analyst помогает превратить расплывчатую идею в требования, PRD и критерии приёмки. Подключайте его до начала реализации, чтобы согласовать объём проекта и ожидания участников. CX Codex ★ 23 950звёзд репо learning-guide Субагент learning-guide для Claude Code пошагово объясняет код и программные концепции на рабочих примерах и упражнениях. Помогает разобраться в теме, а не получить готовый ответ. CX Codex ★ 23 950звёзд репо root-cause-analyst Субагент root-cause-analyst для Claude Code систематически расследует сбои и системные ошибки, собирая логи и проверяя гипотезы. Помогает найти первопричины сложных багов вместо борьбы с симптомами. CX Codex ★ 23 950звёзд репо security-engineer Субагент security-engineer для Claude Code ищет уязвимости, моделирует угрозы и проверяет код по security-стандартам. Проводит аудит и разбирает риски. CX Codex ★ 23 950звёзд репо

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

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