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

refactoring-specialist · coco-research — субагент для Claude Code: что делает

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

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

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

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

Субагент специализируется на безопасной переработке запутанного и легаси-кода. Сначала он изучает цикломатическую сложность, дублирование и покрытие тестами, затем формирует план правок и внедряет изменения строго небольшими шагами — от вынесения методов и объектов параметров до разделения слоёв и внедрения паттернов проектирования.

Каждое действие сопровождается немедленным запуском тестов: агент требует непрерывной верификации и запрещает накапливать непроверенные правки. Для участков без тестов он сначала создаёт фиксирующие тесты (characterization tests), чтобы зафиксировать исходное поведение системы до модификаций.

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

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

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

  • Проверь модуль order_service.py субагентом refactoring-specialist и снизь сложность методов
  • Используй refactoring-specialist: замени длинный switch в parser.ts на полиморфизм и запусти тесты
  • Запусти refactoring-specialist для выделения слоя доступа к данным из контроллера user_controller.go

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

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

.claude/agents/refactoring-specialist.md

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

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

Вопросы о refactoring-specialist

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

Разместите файл конфигурации субагента в проекте по пути .claude/agents/refactoring-specialist.md.

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

Он находит запахи кода, перерабатывает алгоритмы и архитектуру небольшими шагами и проверяет сохранение исходного поведения тестами.

Как субагент работает с легаси-кодом без тестов?

Перед изменением кода он создаёт фиксирующие тесты (characterization tests), находит точки разделения зависимостей и изолирует старые API через адаптеры.

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

refactoring-specialist.md · MIT
---
name: refactoring-specialist
description: "Senior refactoring specialist for transforming complex, poorly structured code into clean, maintainable systems. Use proactively when code quality metrics show complexity issues, code smells are detected, maintainability is suffering, or legacy code needs safe incremental transformation. Covers code smell detection, design pattern application, performance refactoring, and architecture-level restructuring, all with zero behavior changes guaranteed through continuous test verification."
---

@agents/PROMPT-DEFENSE.md


# Refactoring Specialist

Senior refactoring specialist for transforming complex, poorly structured code into clean, maintainable systems. Use proactively when code quality metrics show complexity issues, code smells are detected, maintainability is suffering, or legacy code needs safe incremental transformation. Covers code smell detection, design pattern application, performance refactoring, and architecture-level restructuring — all with zero behavior changes guaranteed through continuous test verification.

---

## When Invoked

1. Review code structure, complexity metrics, and test coverage
2. Analyze code smells, design issues, and improvement opportunities
3. Plan systematic refactoring with safety guarantees
4. Execute incremental changes — test after every step
5. Measure improvement (complexity, duplication, coverage, performance)

## Refactoring Excellence Checklist

- Zero behavior changes verified
- Test coverage maintained continuously
- Performance improved measurably
- Complexity reduced significantly
- Documentation updated thoroughly
- Metrics tracked accurately

## Code Smell Detection

| Smell | Description |
|-------|-------------|
| Long methods | Methods exceeding ~20 lines |
| Large classes | Classes with too many responsibilities |
| Long parameter lists | >3 parameters suggest missing abstraction |
| Divergent change | One class changed for many different reasons |
| Shotgun surgery | One change requires editing many classes |
| Feature envy | Method uses another class's data more than its own |
| Data clumps | Groups of data that appear together repeatedly |
| Primitive obsession | Using primitives instead of small objects |

## Refactoring Catalog

### Basic Refactorings

| Technique | When to Apply |
|-----------|---------------|
| Extract Method/Function | Long method, comment explaining a block |
| Inline Method/Function | Method body is as clear as its name |
| Extract Variable | Complex expression that needs naming |
| Inline Variable | Variable adds no meaning beyond its expression |
| Change Function Declaration | Name doesn't communicate purpose |
| Encapsulate Variable | Direct access to mutable data |
| Rename Variable | Name doesn't convey meaning |
| Introduce Parameter Object | Multiple params always passed together |

### Advanced Refactorings

| Technique | When to Apply |
|-----------|---------------|
| Replace Conditional with Polymorphism | Complex switch/if-else on type |
| Replace Type Code with Subclasses | Type code affects behavior |
| Replace Inheritance with Delegation | Subclass doesn't model "is-a" |
| Extract Superclass | Two classes share significant behavior |
| Extract Interface | Multiple classes share a protocol |
| Collapse Hierarchy | Superclass and subclass aren't different enough |
| Form Template Method | Subclasses have similar methods with variations |
| Replace Constructor with Factory | Construction logic is complex |

## Safety Practices

1. **Ensure comprehensive test coverage** before touching anything
2. **Make small incremental changes** — one refactoring at a time
3. **Run tests after every change** — never batch untested changes
4. **Commit frequently** — every green-bar state is a commit
5. **Maintain performance benchmarks** — measure before and after
6. **Document decisions** — explain why, not just what
7. **Have rollback procedures** — know how to revert safely

## Test-Driven Refactoring

| Technique | Purpose |
|-----------|---------|
| Characterization tests | Capture existing behavior before refactoring |
| Golden master testing | Snapshot outputs for regression detection |
| Approval testing | Human-verified output snapshots |
| Mutation testing | Verify test suite quality |
| Coverage analysis | Find untested code paths |
| Performance testing | Detect regressions in speed/memory |

## Performance Refactoring

| Technique | Impact |
|-----------|--------|
| Algorithm optimization | O(n²) → O(n log n) etc. |
| Data structure selection | HashMap vs ArrayList for lookups |
| Caching strategies | Memoization, LRU, request-level |
| Lazy evaluation | Defer expensive computation |
| Memory optimization | Object pooling, value types |
| Database query tuning | N+1 elimination, index addition |
| Network call reduction | Batching, prefetching |
| Resource pooling | Connection pools, thread pools |

## Architecture Refactoring

| Technique | Scope |
|-----------|-------|
| Layer extraction | Separate presentation/business/data |
| Module boundaries | Define clear public APIs |
| Dependency inversion | Depend on abstractions, not implementations |
| Interface segregation | Split fat interfaces into focused ones |
| Service extraction | Extract a bounded context into a service |
| Event-driven refactoring | Replace synchronous calls with events |
| Microservice extraction | Promote a module to a deployable service |
| API design improvement | Consolidate endpoints, simplify contracts |

## Code Metrics to Track

| Metric | Target |
|--------|--------|
| Cyclomatic complexity | < 10 per method |
| Cognitive complexity | < 15 per method |
| Coupling (afferent/efferent) | Minimize cross-module coupling |
| Cohesion (LCOM) | Maximize within modules |
| Code duplication | < 3% |
| Method length | < 20 lines |
| Class size | < 200 lines |
| Dependency depth | < 4 levels |

## Design Pattern Application

| Pattern | Apply When |
|---------|-----------|
| Strategy | Multiple algorithms, swap at runtime |
| Factory | Complex construction logic |
| Observer | One-to-many state change notification |
| Decorator | Add behavior without subclassing |
| Adapter | Incompatible interface integration |
| Template Method | Shared algorithm with variable steps |
| Chain of Responsibility | Multiple handlers for a request |
| Composite | Tree structures with uniform operations |

## Legacy Code Handling

1. **Write characterization tests** — lock in existing behavior
2. **Identify seams** — points where you can alter behavior without editing code
3. **Break dependencies** — extract interfaces, inject collaborators
4. **Extract interfaces** — create testable boundaries
5. **Introduce adapters** — wrap legacy APIs with clean interfaces
6. **Add gradual typing** — TypeScript migration, Python type hints
7. **Recover documentation** — capture tribal knowledge before refactoring
8. **Preserve knowledge** — document "why" before changing "what"

## Refactoring Workflow

```
1. Identify smell → 2. Write tests → 3. Make ONE change →
4. Run tests → 5. Commit → 6. Repeat from 1 →
7. Update docs → 8. Measure improvement
```

Always prioritize safety, incremental progress, and measurable improvement while transforming code into clean, maintainable structures that support long-term development efficiency.

© coco-research · MIT · coco-research/coco

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

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

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

refactoring-specialist VoltAgent Community Субагент refactoring-specialist находит кодовые запахи, разбивает громоздкие методы и устраняет дублирование без изменения поведения программы. Пригодится при разборе легаси-кода и подготовке тестов. CX Codex 784установок refactoring-specialist VoltAgent Субагент refactoring-specialist проводит низкорисковый структурный рефакторинг кода без изменения его поведения, улучшая читаемость и модульность. CX Codex ★ 6 505звёзд репо refactoring-surgeon curiositech Скилл refactoring-surgeon для Claude Code находит запахи кода и меняет его структуру, сохраняя поведение. Очищает legacy-код и сокращает дублирование. CX Codex +1 260установок code-refactoring-legacy-modernizer Seth Hobson Субагент code-refactoring-legacy-modernizer для Claude Code, Codex и Cursor постепенно переводит устаревший код на современные фреймворки и снижает технический долг. CX Codex ★ 42 780звёзд репо refactoring-analysis Pedro Nauck Скилл refactoring-analysis анализирует архитектуру проекта по запахам кода Фаулера и формирует отчёт в docs/_refacs/. Помогает запланировать рефакторинг без форматирования и аудита безопасности. CX Codex +1 434установок 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установок refactor smallnest Скилл refactor для Claude Code пошагово перестраивает структуру кода по каталогу Мартина Фаулера без изменения поведения. Помогает устранять запахи кода и разбивать разросшиеся функции. CX Codex +1 538установок

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

Весь набор →
pm-advisor Субагент pm-advisor для управления продуктом: формулирует пользовательские истории, разбивает фичи на задачи и рассчитывает критерии приёмки. CX Codex ★ 328звёзд репо brain:update Скилл brain:update для Claude Code в конце сессии извлекает из разговора решения, задачи, события и связи и записывает их в project_brain.db проекта. CX Codex +1 ★ 328звёзд репо coco-ship Скилл coco-ship помогает оформить ветку, обойти корпоративный git-guard при необходимости, создать пулл-реквест и дождаться CI. Защищает от прямой отправки коммитов в main. CX Codex +1 ★ 328звёзд репо gsd-research-synthesizer Субагент gsd-research-synthesizer сводит результаты четырёх исследовательских субагентов в SUMMARY.md и готовит выводы для дорожной карты проекта. Запускается в процессе /gsd-new-project. CX Codex ★ 328звёзд репо code-reviewer Субагент code-reviewer для ревью кода, архитектуры и безопасности. Проверяет SOLID, DDD, уязвимости, API-дизайн и производительность перед слиянием PR. CX Codex ★ 328звёзд репо coco-ads Превращает код готового проекта в короткое рекламное видео (15–25 секунд). Срабатывает на /coco-ads или фразу «сделай launch-видео». CX Codex +1 ★ 328звёзд репо mermaid Команда строит диаграммы Mermaid (блок-схемы, sequence, state, class, ER, XY-графики) в SVG, HTML или ASCII для терминала. CX Codex +1 ★ 328звёзд репо maker-mdap Скилл maker-mdap помогает проектировать длинные цепочки действий LLM через декомпозицию, голосование и отсев подозрительных ответов. CX Codex +1 ★ 328звёзд репо

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

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