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

refactor-project — скилл для Claude Code: рефакторинг всего проекта

Скилл refactor-project для Claude Code, Codex, Cursor и других агентов запускает автоматический рефакторинг сразу по всем файлам проекта. Находит дубли, выравнивает стиль и убирает устаревший код за один прогон.

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

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

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

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

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

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

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

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

Все скиллы по теме «Код-ревью и рефакторинг» →
oma-refactor First Fluke Скилл oma-refactor для Claude Code и Codex перестраивает структуру кода без изменений в его наблюдаемом поведении. Проводит точечный рефакторинг техдолга и горячих точек через мелкие проверенные шаги. CX Codex +1 ★ 1 472звёзд репо refactor-engineer First Fluke Субагент refactor-engineer, который переделывает код, сохраняя его функциональность. Помогает упростить сложные участки, подстраховывая каждый шаг тестами. CX Codex ★ 1 472звёзд репо code-refactor mhattingpete Скилл code-refactor для Claude Code массово переименовывает переменные и функции, заменяет устаревшие паттерны и обновляет вызовы API в нескольких файлах. Для 10+ файлов автоматически выбирает режим, экономящий до 90% токенов. CX Codex +1 304установок improve owainlewis Скилл improve для Claude Code упрощает существующий код, сохраняя его поведение. Агент ищет дубли, мёртвый код, слабые имена и лишние абстракции. CX Codex +1 372установок coding vicotrbb Скилл coding для Claude Code задаёт строгие правила изменения исходного кода. Включается перед написанием, рефакторингом, правкой багов или код-ревью в любом проекте. CX Codex +1 ★ 121звёзд репо

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

Весь набор →
executing-plans Скилл executing-plans для Claude Code, Codex, Cursor и других платформ. Запускает реализацию готового плана разработки пачками задач через изолированных субагентов с финальным коммитом. CX Codex +1 126установок commit-and-push Скилл commit-and-push для Claude Code, Codex, Cursor и других платформ создаёт автоматические коммиты по стандарту Conventional Commits с помощью git-agent и отправляет их на удалённый репозиторий. CX Codex +1 126установок brainstorming Скилл brainstorming для Claude Code и ещё пяти платформ превращает сырые идеи в готовые BDD-спецификации. Запускает исследование репозитория и коммитит архитектурный дизайн без промежуточных расспросов. CX Codex +1 124установок writing-plans Скилл writing-plans для Claude Code, Codex, Cursor и других платформ превращает готовый дизайн в пошаговый план реализации. CX Codex +1 123установок 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установок

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

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