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