refactoring-specialist · voltagent/awesome-codex-subagents — субагент для Codex: что делает
Субагент refactoring-specialist проводит низкорисковый структурный рефакторинг кода без изменения его поведения, улучшая читаемость и модульность.
MIT ★ 6 505 обновлён 2026-10-05
.codex/agents/refactoring-specialist.tomlЧто делает refactoring-specialist
Субагент находит узкие места в структуре проекта и внедряет минимальные точечные правки. В фокусе работы — выделение чистых границ модулей, устранение дублирования и снижение скрытой связности компонентов. Изменения интерфейсов минимизируются, чтобы не ломать код внешних потребителей.
Процесс проверки опирается на тестовое покрытие до и после правок. Субагент валидирует стандартный сценарий, обработку ошибок и граничный случай интеграции. В отчёте он фиксирует найденные первопричины проблем, применённые изменения, компромиссы и оставшийся технический долг.
Субагент жёстко изолирует структурные правки от создания новой функциональности: смешивать задачи запрещено, если родительский агент прямо об этом не попросил.
Какие задачи решает
- разобрать запутанный монолитный модуль на изолированные части
- устранить скрытую связность между компонентами без поломки внешних API
- проверить критические инварианты тестами до и после переписывания кода
- спланировать пошаговую стратегию коммитов для безопасного отката правок
Примеры запросов агенту
- Выдели работу с базой данных из этого контроллера в отдельный сервис
- Упрости этот метод с сохранением поведения и проверь тестами граничные сценарии
- Найди скрытое дублирование в модуле оплаты и предложи минимальный безопасный диф
Как установить refactoring-specialist
Вручную: положить файлы
.codex/agents/refactoring-specialist.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.claude/agents/refactoring-specialist.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.cursor/agents/refactoring-specialist.mdCursor понимает и .claude/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 от других авторов.