refactor · justxor — скилл для Claude Code: безопасный рефакторинг по шагам
Скилл refactor для Claude Code ведёт рефакторинг маленькими шагами без изменения поведения кода. Упрощает модули и убирает дублирование.
MIT ★ 353 обновлён 2026-10-01
npx skills add justxor/claude-code-pro-course --skill refactor -a claude-codeЧто делает refactor
Скилл refactor заставляет агента рефакторить код по строгой процедуре. Сначала проверяется, есть ли тесты на затрагиваемый код и проходят ли они. Если тестов нет, скилл требует сначала написать характеризационные тесты на текущее поведение и закоммитить их.
Дальше агент описывает план: переименование, выделение функции, перенос кода. Каждый шаг должен оставлять проект рабочим. После каждого шага запускаются тесты и проверка типов, при красных тестах шаг откатывается и пробуется другой заход.
Скилл запрещает смешивать рефакторинг с новыми фичами и исправлением багов. Найденные баги уходят в отчёт, а не в код. В конце агент показывает, что изменилось, считает строки и функции до и после, и перечисляет найденные баги. Без зелёных тестов до начала рефакторинга скилл не даст двигаться дальше.
Какие задачи решает
- разделить большой модуль на части, не сломав поведение
- убрать дублирование кода маленькими шагами
- переименовать функции и переменные с проверкой тестов
- зафиксировать текущее поведение характеризационными тестами перед рефакторингом
- получить отчёт с найденными багами и метриками до/после
Примеры запросов агенту
- Отрефактори модуль
src/parser.py, чтобы убрать дублирование - Раздели
services/auth.tsна несколько файлов, поведение не меняй - Упрости
utils/helpers.jsи зафиксируй поведение тестами
Как установить refactor
1Через Skills CLI (Vercel)
npx skills add justxor/claude-code-pro-course --skill refactor -a claude-code2Вручную: положить файлы
~/.claude/skills/refactor/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/refactor/
1Через Skills CLI (Vercel)
npx skills add justxor/claude-code-pro-course --skill refactor -a codex2Вручную: положить файлы
.agents/skills/refactor/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add justxor/claude-code-pro-course --skill refactor -a cursor2Вручную: положить файлы
.cursor/skills/refactor/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install justxor/claude-code-pro-course starter-kit/.claude/skills/refactor2Вручную: положить файлы
.github/skills/refactor/SKILL.md1Через Skills CLI (Vercel)
npx skills add justxor/claude-code-pro-course --skill refactor -a gemini-cli2Командой платформы
gemini skills install https://github.com/justxor/claude-code-pro-course --path starter-kit/.claude/skills/refactorВручную: положить файлы
.devin/skills/refactor/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о refactor
Как установить refactor в Claude Code?
Выполни npx skills add justxor/claude-code-pro-course --skill refactor -a claude-code. Скилл появится в ~/.claude/skills/refactor/SKILL.md.
Что делает скилл refactor?
Проводит рефакторинг маленькими шагами без изменения поведения: сначала тесты, потом план, затем пошаговое выполнение с проверкой тестов и типов после каждого шага. Найденные баги записывает в отчёт, а не исправляет.
Что будет, если на затрагиваемый код нет тестов?
Скилл не начнёт рефакторинг. Сначала агент напишет характеризационные тесты, которые фиксируют текущее поведение, и закоммитит их.
Исходный текст
SKILL.md · MIT
--- name: refactor description: Безопасный рефакторинг маленькими шагами без изменения поведения. Используй, когда просят отрефакторить, упростить, разделить модуль, убрать дублирование или почистить код. argument-hint: <файл или модуль> [цель] --- # Refactor: $ARGUMENTS Правило №1: **поведение не меняется.** 1. Убедись, что тесты для затрагиваемого кода есть и зелёные. Если тестов нет — сначала напиши характеризационные тесты на текущее поведение и закоммить их. 2. Опиши план: список маленьких шагов (переименование, выделение функции, перенос и т.д.). Каждый шаг оставляет проект рабочим. 3. Выполняй шаги по одному. После каждого: - запусти тесты и проверку типов; - если красное — откати шаг и попробуй иначе. 4. Не смешивай рефакторинг с новыми фичами и исправлениями багов. Найденные баги — запиши в отчёт. 5. Итог: что изменилось, метрики (строк/функций до и после), найденные баги, что стоит сделать дальше.
© justxor · MIT · justxor/claude-code-pro-course
Похожие скиллы
Все скиллы по теме «Код-ревью и рефакторинг» →Сначала — refactor от других авторов.