refactoring-code — скилл для Claude Code: что делает и как установить
Скилл refactoring-code для Claude Code ведёт упрощающий рефакторинг: сначала согласует план, затем вносит правки и проверяет, что поведение кода не изменилось.
лицензия не указана 124 установок ★ 3 обновлён 2026-10-25
npx skills add b-mendoza/agent-skills --skill refactoring-code -a claude-codeЧто делает refactoring-code
Скилл ведёт упрощающий рефакторинг так, чтобы поведение кода осталось прежним. Сначала план, потом правки: до утверждения плана ничего не меняется. За один прогон берётся один целевой файл, а сырой код и диффы остаются в субагентах — наружу уходят короткие отчёты.
Внутри четыре субагента: behavior-mapper снимает baseline и список рискованных мест, chunk-analyst разбирает один аспект анализа, refactor-implementer вносит одобренный план, refactor-reviewer выносит два вердикта про сохранение поведения и результат упрощения. План сверяется с references/simplification-heuristics.md, границы задаёт references/protected-surfaces.md, отчёты складываются в .handoffs/refactoring-code/. Из входов обязателен только TARGET_PATH, а MAX_LINES по умолчанию 250.
AUTO_APPROVE=true проверки не отключает: карточка плана принимается сама только когда в ней нет превышения размера, небезопасной команды валидации и обхода защищённых поверхностей. Иначе прогон заканчивается статусом NEEDS_CLARIFICATION. Защищённая поверхность это жёсткий стоп, а повторное согласование расширенного объёма правок при AUTO_APPROVE всегда даёт BLOCKED.
Какие задачи решает
- разбить крупный файл на части без изменения поведения
- убрать дублирование до того, как писать новый код
- переименовать и перенести модуль, не уронив тесты
- выяснить, какие участки кода трогать нельзя
- пройти рефакторинг по коротким отчётам вместо чтения диффов
Примеры запросов агенту
- Упрости
src/billing/invoice.ts, поведение не меняй, тесты:npm test -- invoice - Разбей
src/api/router.tsна части, лимит 300 строк, защищённые поверхности не трогай - Посмотри, есть ли что упростить в
src/queue/worker.ts, но правок пока не делай
Как установить refactoring-code
1Через Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill refactoring-code -a claude-code2Вручную: положить файлы
~/.claude/skills/refactoring-code/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/refactoring-code/
1Через Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill refactoring-code -a codex2Вручную: положить файлы
.agents/skills/refactoring-code/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill refactoring-code -a cursor2Вручную: положить файлы
.cursor/skills/refactoring-code/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install b-mendoza/agent-skills skills/refactoring-code2Вручную: положить файлы
.github/skills/refactoring-code/SKILL.md1Через Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill refactoring-code -a gemini-cli2Командой платформы
gemini skills install https://github.com/b-mendoza/agent-skills --path skills/refactoring-codeВручную: положить файлы
.devin/skills/refactoring-code/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add b-mendoza/agent-skills --skill refactoring-code -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о refactoring-code
Как установить refactoring-code в Claude Code?
Выполните npx skills add b-mendoza/agent-skills --skill refactoring-code -a claude-code. Скилл появится в ~/.claude/skills/refactoring-code/SKILL.md.
Что делает refactoring-code?
Проводит упрощающий рефакторинг по фазам: снимает baseline, предлагает план, после согласования вносит правки и проверяет, что поведение не изменилось. Код и диффы не выходят за пределы субагентов.
Что будет, если правка заденет защищённые поверхности?
Прогон останавливается: пересечение references/protected-surfaces.md считается стопом, пока пользователь не переопределит задачу вне этого скилла.