refactor · fradser — скилл для Claude Code: что делает и как установить
Скилл refactor запускает автоматический рефакторинг выбранных файлов, папок или недавних правок через агента упрощения кода.
MIT 113 установок ★ 597 обновлён 2026-10-09
npx skills add FradSer/dotclaude --skill refactor -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/refactor/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/refactor/
1Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill refactor -a codex2Вручную: положить файлы
.agents/skills/refactor/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill refactor -a cursor2Вручную: положить файлы
.cursor/skills/refactor/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install FradSer/dotclaude refactor/skills/refactor2Вручную: положить файлы
.github/skills/refactor/SKILL.md1Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill refactor -a gemini-cli2Командой платформы
gemini skills install https://github.com/FradSer/dotclaude --path refactor/skills/refactorВручную: положить файлы
.devin/skills/refactor/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill refactor -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.