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

refactor · fradser — скилл для Claude Code: что делает и как установить

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

MIT 113 установок ★ 597 обновлён 2026-10-09

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

Что делает refactor

Скилл определяет область работы по переданным путям или семантическому запросу через Grep. Если вызвать команду без аргументов, она берёт изменённые файлы из git diff --name-only. Из обработки строго исключаются каталоги node_modules/, .git/, dist/, build/ и lock-файлы.

За логику правок отвечает субагент refactor:code-simplifier, который подключает правила refactor:best-practices. Скилл сохраняет публичные интерфейсы и исходное поведение, убирая устаревший код и оптимизируя структуру под конкретный язык программирования.

Команда выполняется сразу без дополнительного подтверждения пользователя, поэтому перед её запуском надёжнее зафиксировать текущее состояние в git. В конце работы скилл выдаёт список изменённых файлов, рекомендуемые тесты и готовую команду отката вроде git restore --worktree --staged <files>.

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

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

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

  • /refactor src/services/auth.ts
  • /refactor
  • /refactor handleUserSession

Как установить refactor

1Через Skills CLI (Vercel)

npx skills add FradSer/dotclaude --skill refactor -a claude-code

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

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

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

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

Вопросы о refactor

Как установить refactor в Claude Code?

Выполните в терминале команду npx skills add FradSer/dotclaude --skill refactor -a claude-code.

Что происходит при вызове /refactor без аргументов?

Скилл запускает git diff --name-only и берёт в работу только недавно изменённые файлы проекта. Если незакоммиченных правок нет, процесс завершится без изменений.

Меняет ли скилл публичные интерфейсы и поведение кода?

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

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

SKILL.md · MIT
---
name: refactor
description: Executes automated refactoring for specific files, directories, or semantic queries. This skill should be used when the user asks to refactor specific files or directories, simplify recently changed code, clean up dead code in a limited scope, or invokes "/refactor".
argument-hint: "[files-or-directories-or-semantic-query]"
allowed-tools: ["Task", "Read", "Bash(git:*)", "Grep", "Glob"]
user-invocable: true
---

# Refactor Command

Execute automated refactoring for $ARGUMENTS using `refactor:code-simplifier` agent.

## Pre-operation Checks
**Goal**: Ensure scope resolution is deterministic before launching the agent.

**Actions**:
1. Run `git rev-parse --is-inside-work-tree` and continue even if false when explicit paths are provided
2. Normalize arguments by trimming whitespace and preserving quoted path segments
3. Treat an empty argument list as "recent changes" mode

## Phase 1: Determine Target Scope
**Goal**: Identify files to refactor based on arguments or session context.

**Actions**:
1. If arguments provided: verify as file/directory paths using Glob
2. If paths exist: use them directly as refactoring scope
3. If paths don't exist: treat arguments as semantic query, search codebase with Grep
4. If no arguments: run `git diff --name-only` to find recently modified code files
5. If no recent changes found: inform user and exit without refactoring

CRITICAL: Never include `node_modules/`, `.git/`, `dist/`, `build/`, lock files, or compiled artifacts in refactoring scope — use Grep `--glob` exclusions to enforce.

See `references/scope-determination.md` for search strategies and edge cases.

## Phase 2: Launch Refactoring Agent
**Goal**: Execute `refactor:code-simplifier` agent with aggressive mode enabled.

**Actions**:
1. Launch `refactor:code-simplifier` agent with target scope and aggressive mode flag
2. Pass scope determination method (paths, semantic query, or session context)
3. Agent auto-loads `refactor:best-practices` skill and applies language-specific patterns

See `references/agent-configuration.md` for detailed Task parameters.

## Phase 3: Summary
**Goal**: Report comprehensive summary of changes.

**Actions**:
1. Report total files refactored and changes categorized by improvement type
2. List best practices applied and legacy code removed
3. Suggest tests to run and provide rollback command tailored to actual scope (for example: `git restore --worktree --staged <files>`)

See `references/output-requirements.md` for detailed summary format.

## Requirements

- Execute immediately without user confirmation
- Refactor ALL matching files when semantic search returns multiple results
- Direct users to `/refactor-project` for project-wide scope
- Preserve behavior and public interfaces unless user explicitly requests a behavior change

© FradSer · MIT · FradSer/dotclaude

Похожие скиллы

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

Сначала — 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-cleaner sangrokjung Субагент refactor-cleaner находит мёртвый код, неиспользуемые экспорты и зависимости через knip, depcheck и ts-prune, проверяет ссылки и удаляет лишнее маленькими партиями. CX Codex ★ 880звёзд репо deslop prathamdby Скилл deslop для Claude Code, Codex и Cursor убирает из диффа лишний шум и слоп, сохраняя поведение кода. Анализирует изменения в Git и правит код минимальными шагами. CX Codex +1 736установок antfu-simplify Anthony Fu Скилл antfu-simplify для Claude Code и Codex уменьшает текущий diff ветки или рабочей копии через абляцию, убирая лишние слои абстракции. CX Codex +1 312установок code-refactor-review jnsahaj Скилл code-refactor-review для Claude Code разбирает diff и PR на повторное использование, связность и соответствие стилю проекта. Проверяет рефакторинг. CX Codex +1 181установок refactor-guided CloudAI-X Команда refactor-guided проводит структурный рефакторинг по шагам и проверяет тесты после каждого изменения. Подходит для безопасной перестройки кода без добавления функций. CX Codex +1 ★ 1 424звёзд репо refactor-specialist NYCU-Chung Субагент refactor-specialist для Claude Code помогает безопасно менять структуру кода в нескольких файлах. Он подключается для переименования сущностей, переноса файлов и выделения модулей. CX Codex ★ 267звёзд репо

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

Весь набор →
plugin-best-practices Скилл plugin-best-practices для проверки структуры, манифестов и архитектуры Claude Code плагинов по стандартам фреймворка. Помогает убедиться, что плагин соответствует требованиям до отправки в маркетплейс. CX Codex +1 121установок commit Скилл commit для Claude Code создаёт атомарные conventional-коммиты через git-agent. Оформляет изменения по краткому намерению. CX Codex +1 121установок optimize-plugin Скилл optimize-plugin проверяет структуру плагинов Claude, запускает Python-валидатор и исправляет найденные ошибки через агента. Пригодится при подготовке и рефакторинге расширений. CX Codex +1 117установок create-prd Скилл create-prd помогает собрать идею продукта в PRD: задаёт вопросы, выбирает формат и сохраняет готовый документ в Markdown или Feishu. CX Codex +1 117установок create-issues Скилл create-issues автоматизирует создание GitHub issues с соблюдением принципов TDD, правильной разметкой и auto-closing ключевыми словами. Помогает документировать баги, требования и PR-scoped задачи по единым стандартам. CX Codex +1 116установок best-practices Скилл best-practices задаёт правила качества кода и шаблоны под TypeScript, Python, Go, Swift и React. CX Codex +1 115установок resolve-issues Скилл resolve-issues для Claude Code решает GitHub issues через изолированный worktree и TDD. Затем передаёт создание PR в workflow проверки и ревью. CX Codex +1 112установок create-pr Скилл create-pr создаёт GitHub pull request после проверок качества и безопасности, а затем передаёт его на мониторинг CI и разбор комментариев. CX Codex +1 109установок

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

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