refactor-project — скилл для Claude Code: рефакторинг всего проекта
Скилл refactor-project для Claude Code, Codex, Cursor и других агентов запускает автоматический рефакторинг сразу по всем файлам проекта. Находит дубли, выравнивает стиль и убирает устаревший код за один прогон.
MIT 122 установок ★ 597 обновлён 2026-10-09
npx skills add FradSer/dotclaude --skill refactor-project -a claude-codeЧто делает refactor-project
Перед стартом скилл проверяет, что папка находится в git-репозитории: без этого режим проекта недоступен. Текущий коммит записывается в итоговую сводку, чтобы можно было откатиться командой git restore --worktree --staged ..
Внутри три фазы. Сначала Glob обходит все исходники, исключая node_modules/, .git/, dist/, build/, vendor/ и .venv/. Затем запускается агент refactor:code-simplifier с флагом агрессивного режима для удаления легаси — он подтягивает скилл refactor:best-practices и применяет паттерны под конкретный язык. После завершения скилл выводит статистику: сколько файлов изменено, какие межфайловые дубли устранены, какие практики применены.
Поведение и публичные интерфейсы не меняются — только если пользователь явно этого попросит.
Какие задачи решает
- устранить повторяющийся код сразу во всех файлах проекта
- привести именование и стиль к единому виду по всей кодовой базе
- удалить устаревший код в агрессивном режиме
- получить точку отката перед масштабным рефакторингом
- запустить рефакторинг без подтверждения на каждом шаге
Примеры запросов агенту
- Запусти рефакторинг по всему проекту
/refactor-project - Почисти дубли и выровняй стиль во всех файлах
- Удали легаси-код по всей кодовой базе
Как установить refactor-project
1Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill refactor-project -a claude-code2Вручную: положить файлы
~/.claude/skills/refactor-project/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/refactor-project/
1Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill refactor-project -a codex2Вручную: положить файлы
.agents/skills/refactor-project/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill refactor-project -a cursor2Вручную: положить файлы
.cursor/skills/refactor-project/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install FradSer/dotclaude refactor/skills/refactor-project2Вручную: положить файлы
.github/skills/refactor-project/SKILL.md1Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill refactor-project -a gemini-cli2Командой платформы
gemini skills install https://github.com/FradSer/dotclaude --path refactor/skills/refactor-projectВручную: положить файлы
.devin/skills/refactor-project/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill refactor-project -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о refactor-project
Как установить refactor-project в Claude Code?
Выполните npx skills add FradSer/dotclaude --skill refactor-project -a claude-code. Скилл появится по пути ~/.claude/skills/refactor-project/SKILL.md.
Что делает скилл refactor-project?
Обходит все исходные файлы проекта, запускает агент refactor:code-simplifier с кросс-файловой оптимизацией и выводит сводку изменений с командой для отката.
Нужен ли git для работы refactor-project?
Да. Скилл проверяет наличие git-репозитория через git rev-parse --is-inside-work-tree: без него режим проекта не запустится.
Исходный текст
SKILL.md · MIT
--- name: refactor-project description: Executes automated project-wide refactoring with a focus on cross-file optimization. This skill should be used when the user asks for project-wide refactoring, cross-file simplification, consistency standardization across the codebase, duplication reduction, or invokes "/refactor-project". argument-hint: (no arguments needed) allowed-tools: ["Task", "Read", "Bash(git:*)", "Grep", "Glob"] user-invocable: true --- # Refactor Project Command Execute automated project-wide refactoring using `refactor:code-simplifier` agent with cross-file optimization focus. ## Pre-operation Checks **Goal**: Ensure project-wide execution is explicit and reproducible. **Actions**: 1. Run `git rev-parse --is-inside-work-tree`; if false, inform user that project-wide mode requires a git workspace 2. Record current revision with `git rev-parse --short HEAD` and include it in final summary for rollback context 3. Ignore command arguments and proceed with full-project discovery ## Phase 1: Analyze Project Scope **Goal**: Discover all code files and display scope summary. **Actions**: 1. Find all code files using Glob patterns for common extensions 2. Filter out `node_modules/`, `.git/`, `dist/`, `build/`, `vendor/`, `.venv/` 3. Group files by language/extension and identify primary source directories 4. Display scope summary (file count, languages, directories) then proceed automatically See `references/scope-analysis.md` for exclusion patterns and edge cases. ## Phase 2: Launch Refactoring Agent **Goal**: Execute `refactor:code-simplifier` agent with project-wide scope and cross-file focus. **Actions**: 1. Launch `refactor:code-simplifier` agent with all discovered code files 2. Pass cross-file optimization emphasis: duplication reduction, consistent patterns 3. Pass aggressive mode flag for legacy code removal 4. 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 project-wide changes. **Actions**: 1. Report total files refactored (count and percentage of project) 2. List changes categorized by improvement type and cross-file improvements made 3. List best practices applied and legacy code removed 4. Suggest test suite to run and recommend reviewing changes in logical groups 5. Provide safer rollback command tied to recorded baseline (for example: `git restore --worktree --staged .`) See `references/output-requirements.md` for detailed summary format. ## Requirements - Execute immediately after displaying scope (no confirmation needed) - Refactor entire project across all discovered code files - Prioritize cross-file duplication reduction and consistent patterns - Preserve behavior and public interfaces unless user explicitly requests a behavior change
© FradSer · MIT · FradSer/dotclaude