К основному содержанию
скилл CX Codex

refactor · justxor — скилл для Claude Code: безопасный рефакторинг по шагам

Скилл refactor для Claude Code ведёт рефакторинг маленькими шагами без изменения поведения кода. Упрощает модули и убирает дублирование.

MIT ★ 353 обновлён 2026-10-01

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add justxor/claude-code-pro-course --skill refactor -a claude-code
Открыть на GitHub

Что делает 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-code

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

~/.claude/skills/refactor/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/refactor/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

refactor официальный github Скилл refactor для GitHub Copilot меняет структуру существующего кода без изменения его поведения. Помогает убирать дублирование, сложные функции и кодовые запахи. CX Codex +1 22 321установок refactor parcadei Скилл refactor для Claude Code проводит рефакторинг через анализ, план, реализацию, ревью и проверку тестов. Запускается на просьбы изменить структуру кода без смены его поведения. CX Codex +1 625установок refactor smallnest Скилл refactor для Claude Code пошагово перестраивает структуру кода по каталогу Мартина Фаулера без изменения поведения. Помогает устранять запахи кода и разбивать разросшиеся функции. CX Codex +1 538установок refactor boshu2 Скилл refactor для Claude Code реорганизует код без изменения логики с проверкой тестами до и после правок. Включается по запросу на очистку, дедупликацию или вынесение функции. CX Codex +1 123установок refactor pproenca Скилл refactor для Claude Code содержит 43 правила рефакторинга по каталогу Мартина Фаулера и принципам Clean Code. Агент применяет их при правке чужого кода. CX Codex +1 661установок refactor-method-complexity-reduce официальный github Скилл refactor-method-complexity-reduce рефакторит выбранный метод, снижая когнитивную сложность через вынос логики в хелперы. Подходит для длинных ветвлений и вложенных условий. CX Codex +1 9 992установок w-refactor blockmatic-icebox Скилл w-refactor для Claude Code помогает менять структуру кода, сохраняя его поведение. Перед правками он предлагает зафиксировать исходное поведение тестами, проверками типов или ручным сценарием. CX Codex +1 647установок refactor-legacy-code aj-geddes Скилл refactor-legacy-code помогает пошагово обновлять старый код без поломки логики. Пригодится при разборе техдолга и устаревших API. CX Codex +1 611установок deep-module-refactor zebbern Скилл deep-module-refactor ищет неглубокие модули в проекте, проектирует через субагентов более плотные интерфейсы и оформляет RFC в тикетах GitHub. Помогает упростить тестирование на границах кода. CX Codex +1 ★ 4 719звёзд репо oma-refactor First Fluke Скилл oma-refactor для Claude Code и Codex перестраивает структуру кода без изменений в его наблюдаемом поведении. Проводит точечный рефакторинг техдолга и горячих точек через мелкие проверенные шаги. CX Codex +1 ★ 1 472звёзд репо lsp-refactor blackwell-systems Скилл lsp-refactor для Claude Code проводит рефакторинг через анализ связей, предварительную симуляцию правок, сборку и тесты. Если у цели больше 20 ссылок, он запрашивает подтверждение. CX Codex +1 ★ 182звёзд репо

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

Весь набор →
pr-description Скилл pr-description собирает заголовок и структурированное описание pull request по коммитам и диффу ветки относительно main. CX Codex +1 ★ 353звёзд репо architect Субагент architect для Claude Code изучает проект и предлагает варианты архитектуры с планом внедрения. Планирует архитектуру новых функций и крупных изменений. CX Codex ★ 353звёзд репо code-reviewer Субагент code-reviewer читает дифф перед коммитом или PR: ищет дыры в безопасности, пропущенные тесты и граничные случаи, отдаёт разбор по приоритетам. CX Codex ★ 353звёзд репо write-tests Скилл write-tests генерирует unit-тесты для указанного файла или функции, повторяя стиль тестов проекта. Запускает проверку и находит скрытые ошибки в коде. CX Codex +1 ★ 353звёзд репо commit Скилл в Claude Code изучает текущие изменения и создаёт git-коммит в формате Conventional Commits. Коммитит работу, сохраняя стиль сообщений репозитория. CX Codex +1 ★ 353звёзд репо release-notes Собирает список изменений и release notes по тегам Git или от свежего тега к HEAD с группировкой по Conventional Commits. CX Codex +1 ★ 353звёзд репо onboard Скилл onboard для Claude Code знакомит нового разработчика с проектом: объясняет архитектуру, запуск и ключевые потоки. Помогает быстро разобраться с незнакомой кодовой базой. CX Codex +1 ★ 353звёзд репо code-review Скилл code-review проверяет изменения в текущей ветке относительно main и выдаёт отчёт с замечаниями по корректности, безопасности, тестам и читаемости. CX Codex +1 ★ 353звёзд репо

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

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