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

refactoring-specialist · voltagent/awesome-codex-subagents — субагент для Codex: что делает

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

MIT ★ 6 505 обновлён 2026-10-05

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

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

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

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

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

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

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

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

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

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

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

.codex/agents/refactoring-specialist.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

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

Вопросы о refactoring-specialist

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

Сохраните конфигурацию субагента в файл .codex/agents/refactoring-specialist.toml внутри вашего проекта.

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

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

Добавляет ли субагент новые фичи во время рефакторинга?

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

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

refactoring-specialist.toml · MIT
# refactoring-specialist

Use when a task needs a low-risk structural refactor that preserves behavior while improving readability, modularity, or maintainability.

Own behavior-preserving refactoring work as developer productivity and workflow reliability engineering, not checklist execution.

Prioritize the smallest practical change or recommendation that reduces friction, preserves safety, and improves day-to-day delivery speed.

Working mode:
1. Map the workflow boundary and identify the concrete pain/failure point.
2. Distinguish evidence-backed root causes from symptoms.
3. Implement or recommend the smallest coherent intervention.
4. Validate one normal path, one failure path, and one integration edge.

Focus on:
- scope control to isolate structural change from feature change
- seam extraction and modular boundary improvements with minimal churn
- reduction of complexity, duplication, and hidden coupling
- test safety net quality around refactored code paths
- API/interface stability for downstream callers
- incremental commit strategy enabling safe review and rollback
- preservation of runtime behavior and non-functional expectations

Quality checks:
- verify refactor diff keeps behavior equivalent on critical paths
- confirm structural improvements are measurable and localized
- check tests cover key invariants before and after refactor
- ensure compatibility risks are identified where signatures or contracts shift
- call out residual technical debt intentionally deferred

Return:
- exact workflow/tool boundary analyzed or changed
- primary friction/failure source and supporting evidence
- smallest safe change/recommendation and key tradeoffs
- validations performed and remaining environment-level checks
- residual risk and prioritized follow-up actions

Do not mix unrelated feature work into structural refactor changes unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

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

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

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

refactoring-specialist VoltAgent Community Субагент refactoring-specialist находит кодовые запахи, разбивает громоздкие методы и устраняет дублирование без изменения поведения программы. Пригодится при разборе легаси-кода и подготовке тестов. CX Codex 784установок refactoring-specialist coco-research Субагент refactoring-specialist для Claude Code пошагово устраняет запахи кода и снижает сложность, проверяя тестами каждое изменение и сохраняя логику системы. CX Codex ★ 328звёзд репо refactoring-patterns proffesor-for-testing Скилл refactoring-patterns для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode, который применяет паттерны рефакторинга. Запускается, когда нужно улучшить структуру кода без изменения поведения. CX Codex +1 140установок refactoring-expert SuperClaude-Org Субагент refactoring-expert снижает цикломатическую сложность кода и устраняет технический долг через принципы SOLID. Пригодится при безопасном рефакторинге без изменения поведения системы. CX Codex ★ 23 950звёзд репо dry-refactoring kucherenko Скилл dry-refactoring автоматизирует рефакторинг копипастных дубликатов, которые находит jscpd. Предлагает стратегии извлечения функции, параметризации, модуля или класса и показывает, с каких файлов начать. CX Codex +1 4 100установок safe-refactor JuliusBrussee Скилл safe-refactor ограничивает рефакторинг сохранением поведения: фиксирует проверки до правок кода, запрещает смешивать перенос структуры с новыми фичами. CX Codex +1 130 700установок codebase-refactoring kucherenko Скилл codebase-refactoring запускает аудит кодовой базы через утилиту jscpd. Помогает пошагово сократить дублирование, вычистить мёртвый код и упростить перегруженные файлы. CX Codex +1 704установок code-refactoring akillness Скилл code-refactoring помогает спланировать рефакторинг без изменения поведения: от фиксации текущих гарантий до небольших проверяемых шагов. CX Codex +1 552установок

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

Весь набор →
api-documenter api-documenter — субагент для генерации документации API по реализации, схемам и примерам; проверяет соответствие спецификации коду. CX Codex ★ 6 505звёзд репо visual-asset-generator Субагент visual-asset-generator генерирует иконки приложений, фавиконки, логотипы и OG-изображения под точные размеры проекта через MCP-сервер prompt-to-asset. CX Codex ★ 6 505звёзд репо tooling-engineer Субагент tooling-engineer помогает проектировать и проверять внутренние скрипты, автоматизацию и служебные команды. Подключайте его, когда рабочий процесс ломается на инструментах или окружении. CX Codex ★ 6 505звёзд репо slack-expert Субагент slack-expert для Codex помогает разрабатывать интеграции со Slack: ботов, обработчики событий и рабочие процессы. Он подключается к задачам, где важны интерактивность и поведение платформы. CX Codex ★ 6 505звёзд репо readme-generator Субагент readme-generator для Codex собирает README по реальным файлам репозитория и проверяет команды, настройки и примеры. Готовит документацию без выдуманных инструкций. CX Codex ★ 6 505звёзд репо powershell-ui-architect Субагент powershell-ui-architect для Codex проектирует интерфейсы на PowerShell для терминалов, форм, WPF и административных инструментов. Разбирает сбои и неудобства в интерактивных сценариях. CX Codex ★ 6 505звёзд репо powershell-module-architect Субагент powershell-module-architect проектирует структуру модулей PowerShell, проверяет контракты команд Verb-Noun и организует упаковку без лишней переделки API. CX Codex ★ 6 505звёзд репо mcp-developer Субагент mcp-developer для Codex разбирает MCP-серверы и клиенты, схемы инструментов и интеграции. Проверяет совместимость протокола и обработку ошибок. CX Codex ★ 6 505звёзд репо

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

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