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

refactor · rsmdt — скилл для Claude Code: рефакторинг и установка

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

MIT ★ 587 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup
Открыть на GitHub

Что делает refactor

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

Перед изменениями скилл запускает тесты как базовую проверку. После каждого отдельного изменения он снова запускает тесты; при сбое откатывает правку. Для кода без тестового покрытия он сначала спрашивает пользователя, как поступить, а рефакторинг нетестированного кода требует одобрения. Это значит, что без согласия пользователя такой код останется без изменений.

Скилл ограничивает работу внутренней структурой: он не должен менять внешнее поведение, публичные API и результаты бизнес-логики. В конце запускается полный набор тестов, а пользователю предлагают выбрать дальнейшее действие.

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

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

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

  • /refactor упрости этот метод, сохранив его поведение.
  • /refactor найди дублирование в src/ и предложи порядок исправлений.
  • /refactor замени магические числа в этом файле именованными константами.

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

1Через маркетплейс плагинов

/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup

Команда ставит плагин start целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add rsmdt/the-startup --skill refactor -a claude-code

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

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

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

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

Вопросы о refactor

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

Добавьте маркетплейс командой /plugin marketplace add rsmdt/the-startup, затем установите плагин командой /plugin install start@the-startup.

Что делает refactor?

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

Как скилл работает с кодом без тестового покрытия?

Он предлагает сначала добавить тесты, продолжить без покрытия или отменить работу. Для рефакторинга нетестированного кода нужно одобрение пользователя.

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

SKILL.md · MIT
---
name: refactor
description: Refactor, simplify, or clean up code for improved maintainability without changing business logic
user-invocable: true
argument-hint: "describe what code needs refactoring and why"
---

## Persona

Act as a refactoring orchestrator that improves code quality while strictly preserving all existing behavior.

**Refactoring Target**: $ARGUMENTS

## Interface

Finding {
  impact: HIGH | MEDIUM | LOW
  title: string            // max 40 chars
  location: string         // shortest unique path + line
  problem: string          // one sentence
  refactoring: string      // specific technique to apply
  risk: string             // potential complications
}

State {
  target = $ARGUMENTS
  perspectives = []              // from reference/perspectives.md
  mode: Standard | Agent Team | Dynamic Workflow
  baseline: string
  findings: Finding[]
}

**In scope:** Code structure, internal implementation, naming, duplication, readability, dependencies. Specific techniques: nested ternaries to if/else or switch, dense one-liners to multi-line with clear steps, clever tricks to obvious implementations, abbreviations to descriptive names, magic numbers to named constants.
**Out of scope:** External behavior, public API contracts, business logic results, side effect ordering.

## Constraints

**Always:**
- Delegate all analysis tasks to specialist agents.
- Establish test baseline before any changes.
- Run tests after EVERY individual change.
- One refactoring at a time — never batch changes before verification.
- Revert immediately if tests fail or behavior changes.
- Get user approval before refactoring untested code.

**Never:**
- Change external behavior, public API contracts, or business logic results.

## Reference Materials

- reference/perspectives.md — analysis perspectives
- reference/code-smells.md — smell catalog
- reference/output-format.md — output guidelines
- examples/output-example.md — output example

## Workflow

### 1. Establish Baseline

Locate target code from $ARGUMENTS. Run existing tests to establish baseline.
Read reference/output-format.md and format the baseline report accordingly.

match (baseline) {
  tests failing => stop, report to user
  coverage gaps => ask the user to choose: Add tests first (recommended) | Proceed without coverage | Cancel
  ready         => continue
}

### 2. Select Mode

Ask the user to choose:
  Standard (default) — parallel fire-and-forget analysis agents
  Agent Team — persistent analyst teammates with coordination
  Dynamic Workflow — one inline workflow script fans out the analysts and collects their findings (analysis only; changes stay sequential)

Recommend Agent Team when scope >= 5 files, multiple interconnected modules, or large codebase.
Recommend Dynamic Workflow instead when those thresholds apply but the analysts need no coordination with each other.

### 3. Analyze Issues

Read reference/perspectives.md for perspective definitions.

Determine perspectives based on target intent: use simplification perspectives for within-function readability work, standard perspectives for structural/architectural refactoring.

match (mode) {
  Standard => launch parallel subagents per applicable perspectives
  Agent Team => create team, spawn one analyst per perspective, assign tasks
  Dynamic Workflow => run one dynamic workflow: one analyst agent per perspective in parallel, returning every finding; no agent in it edits code
}

For Dynamic Workflow, these instructions are the opt-in: call the Workflow tool directly with an inline script. Do not load the workflow-authoring reference or assemble the script through shell commands first — runs that detour through either stall before launching. Choose `model` and `effort` per stage from what the stage does. Mechanical stages — running a command, gathering or quoting sources, mapping text into a fixed schema — can run on a smaller, faster model at lower effort. Analysis, writing, and judging another agent's work need the strongest model. A judging stage never runs on a weaker model than the stage it judges. When unsure, omit `model` so the stage inherits the session model.

Process findings:
1. Deduplicate overlapping issues.
2. Rank by impact (descending), then risk (ascending).
3. Sequence independent items first, dependent items after.

Read reference/output-format.md and present analysis summary accordingly.
Ask the user to choose: Document and proceed | Proceed without documenting | Cancel

If Cancel: stop, report summary of findings discovered.

### 4. Execute Changes

Apply changes sequentially — behavior preservation requires it.

For each refactoring in findings:
1. Apply single change.
2. Run tests immediately.
3. If tests pass: mark complete, continue.
4. If tests fail: `git checkout -- <changed files>`. Read reference/output-format.md for error recovery format.

### 5. Final Validation

Run complete test suite. Compare behavior with baseline.
Read reference/output-format.md and present completion summary accordingly.
Ask the user to choose: Commit changes | Run full test suite | Address skipped items | Done

© Rudolf S. · MIT · rsmdt/the-startup

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

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

Сначала — 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установок oma-refactor First Fluke Скилл oma-refactor для Claude Code и Codex перестраивает структуру кода без изменений в его наблюдаемом поведении. Проводит точечный рефакторинг техдолга и горячих точек через мелкие проверенные шаги. CX Codex +1 ★ 1 472звёзд репо refactor-expert alirezarezvani Субагент refactor-expert для Claude Code анализирует качество кода и планирует безопасный рефакторинг. Ищет дублирование, архитектурные проблемы и пробелы в тестах. CX Codex ★ 788звёзд репо refactor-code davila7 Слэш-команда refactor-code ведёт агента по 17 шагам рефакторинга: от анализа и тестов до проверки производительности и подготовки к ревью. CX Codex +1 4 890установок safe-refactor JuliusBrussee Скилл safe-refactor ограничивает рефакторинг сохранением поведения: фиксирует проверки до правок кода, запрещает смешивать перенос структуры с новыми фичами. CX Codex +1 130 700установок refactor-project FradSer Скилл refactor-project для Claude Code, Codex, Cursor и других агентов запускает автоматический рефакторинг сразу по всем файлам проекта. Находит дубли, выравнивает стиль и убирает устаревший код за один прогон. CX Codex +1 122установок refactor-engineer First Fluke Субагент refactor-engineer, который переделывает код, сохраняя его функциональность. Помогает упростить сложные участки, подстраховывая каждый шаг тестами. CX Codex ★ 1 472звёзд репо

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

Весь набор →
brainstorm Скилл brainstorm для Claude Code пошагово проектирует фичи до написания кода: задаёт вопросы по одному, предлагает варианты реализации и фиксирует архитектурные решения. CX Codex +1 ★ 587звёзд репо architecture-selection Скилл architecture-selection для Claude Code сравнивает архитектурные паттерны и помогает выбрать подход под требования проекта. Выбирает архитектуру для проектирования системы и оценки масштабирования. CX Codex +1 ★ 587звёзд репо security-assessment Скилл security-assessment для Claude, который проводит аудит безопасности: модель угроз по STRIDE, разбор кода по OWASP и находки с приоритетом и шагами исправления. CX Codex +1 ★ 587звёзд репо technical-writing Скилл technical-writing составляет архитектурные решения (ADR), системную документацию, описания API и эксплуатационные регламенты прямо в репозитории проекта. CX Codex +1 ★ 587звёзд репо requirements-elicitation Скилл requirements-elicitation превращает размытые идеи в чёткие требования с приоритетами и критериями приёмки. Разбирает конфликты стейкхолдеров, выявляет реальные потребности и документирует границы проекта. CX Codex +1 ★ 587звёзд репо pattern-detection Скилл pattern-detection находит правила именования, архитектурные слои и форматы тестов в проекте. Помогает писать новый код в едином стиле кодовой базы. CX Codex +1 ★ 587звёзд репо monitor-production Субагент monitor-production настраивает метрики, логи, трассировки, оповещения и дашборды для продакшена. Пригодится при запуске мониторинга, настройке SLO и разборе сбоев. CX Codex ★ 587звёзд репо review-compatibility Субагент review-compatibility для Claude Code, который проверяет код на breaking changes в API, базах данных и конфигах. CX Codex ★ 587звёзд репо

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

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