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

code-refactor — скилл для Claude Code: переименование и замена кода

Скилл code-refactor для Claude Code массово переименовывает переменные и функции, заменяет устаревшие паттерны и обновляет вызовы API в нескольких файлах. Для 10+ файлов автоматически выбирает режим, экономящий до 90% токенов.

Apache-2.0 304 установок ★ 697 обновлён 2026-07-25

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

Что делает code-refactor

code-refactor помогает рефакторить код структурированно. Сначала находит все вхождения паттерна (переменная, функция, строка кода), показывает контекст каждого совпадения, потом применяет замену одновременно во всех найденных местах.

Для 1–9 файлов скилл использует встроенные инструменты: поиск по grep и правку с флагом replace_all=true. Если файлов 10 и больше, автоматически переключается на режим выполнения с Python-скриптом — это даёт 90% экономию токенов на больших кодовых базах. Например, переименование в 50 файлах требует примерно 500 токенов вместо 25 000.

Скилл учитывает граничные случаи: спрашивает, обновлять ли совпадения внутри строк и комментариев, предупреждает о breaking changes в публичных API. Рекомендует запустить тесты после каждого изменения.

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

  • переименовать переменную или функцию во всём проекте
  • заменить устаревший паттерн (например, var на let)
  • обновить все вызовы к API (сменить версию эндпоинта)
  • унифицировать код по новому стилю или библиотеке
  • найти и удалить дублированный код в нескольких местах

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

  • Переименуй getUserData на fetchUserData во всех файлах
  • Замени все /api/auth/login на /api/v2/authentication/login
  • Обнови все var на let в папке src/, но только при условии переприсваивания

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

1Через Skills CLI (Vercel)

npx skills add mhattingpete/claude-skills-marketplace --skill code-refactor -a claude-code

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

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

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

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

Вопросы о code-refactor

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

Выполни npx skills add mhattingpete/claude-skills-marketplace --skill code-refactor -a claude-code, потом проверь файл ~/.claude/skills/code-refactor/SKILL.md.

Что делает code-refactor?

Находит все вхождения кода (переменная, функция, паттерн) по всему проекту, показывает контекст каждого совпадения и применяет замену одновременно во всех найденных файлах. Для больших кодовых баз (10+ файлов) автоматически использует Python-скрипт и экономит токены.

В чём разница между режимом для 1–9 файлов и 10+ файлов?

До 9 файлов скилл работает встроенными инструментами (grep + edit). Начиная с 10 файлов, переключается на code-execution с Python-скриптом rename_identifier — экономит 90% токенов, особенно полезно для больших проектов.

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

SKILL.md · Apache-2.0
---
name: code-refactor
description: Perform bulk code refactoring operations like renaming variables/functions across files, replacing patterns, and updating API calls. Use when users request renaming identifiers, replacing deprecated code patterns, updating method calls, or making consistent changes across multiple locations.
---

# Code Refactor

Systematic code refactoring across files. **Auto-switches to execution mode** for 10+ files (90% token savings).

## Mode Selection

- **1-9 files**: Use native tools (Grep + Edit with replace_all)
- **10+ files**: Automatically use `code-execution` skill

**Execution example (50 files):**
```python
from api.code_transform import rename_identifier
result = rename_identifier('.', 'oldName', 'newName', '**/*.py')
# Returns: {'files_modified': 50, 'total_replacements': 247}
# ~500 tokens vs ~25,000 tokens traditional
```

## When to Use

- "rename [identifier] to [new_name]"
- "replace all [pattern] with [replacement]"
- "refactor to use [new_pattern]"
- "update all calls to [function/API]"
- "convert [old_pattern] to [new_pattern]"

## Core Workflow (Native Mode)

### 1. Find All Occurrences
```
Grep(pattern="getUserData", output_mode="files_with_matches")     # Find files
Grep(pattern="getUserData", output_mode="content", -n=true, -B=2, -A=2)  # Verify with context
```

### 2. Replace All Instances
```
Edit(
  file_path="src/api.js",
  old_string="getUserData",
  new_string="fetchUserData",
  replace_all=true
)
```

### 3. Verify Changes
```
Grep(pattern="getUserData", output_mode="files_with_matches")  # Should return none
```

## Workflow Examples

### Rename Function
1. Find: `Grep(pattern="getUserData", output_mode="files_with_matches")`
2. Count: "Found 15 occurrences in 5 files"
3. Replace in each file with `replace_all=true`
4. Verify: Re-run Grep
5. Suggest: Run tests

### Replace Deprecated Pattern
1. Find: `Grep(pattern="\\bvar\\s+\\w+", output_mode="content", -n=true)`
2. Analyze: Check if reassigned (let) or constant (const)
3. Replace: `Edit(old_string="var count = 0", new_string="let count = 0")`
4. Verify: `npm run lint`

### Update API Calls
1. Find: `Grep(pattern="/api/auth/login", output_mode="content", -n=true)`
2. Replace: `Edit(old_string="'/api/auth/login'", new_string="'/api/v2/authentication/login'", replace_all=true)`
3. Test: Recommend integration tests

## Best Practices

**Planning:**
- Find all instances first
- Review context of each match
- Inform user of scope
- Consider edge cases (strings, comments)

**Safe Process:**
1. Search → Find all
2. Analyze → Verify appropriate
3. Inform → Tell user scope
4. Execute → Make changes
5. Verify → Confirm applied
6. Test → Suggest running tests

**Edge Cases:**
- Strings/comments: Ask if should update
- Exported APIs: Warn of breaking changes
- Case sensitivity: Be explicit

## Tool Reference

**Edit with replace_all:**
- `replace_all=true`: Replace all occurrences
- `replace_all=false`: Replace only first (or fail if multiple)
- Must match EXACTLY (whitespace, quotes)

**Grep patterns:**
- `-n=true`: Show line numbers
- `-B=N, -A=N`: Context lines
- `-i=true`: Case-insensitive
- `type="py"`: Filter by file type

## Integration

- **test-fixing**: Fix broken tests after refactoring
- **code-transfer**: Move refactored code
- **feature-planning**: Plan large refactorings

© mhattingpete · Apache-2.0 · mhattingpete/claude-skills-marketplace

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

Все скиллы по теме «Код-ревью и рефакторинг» →
refactor-project FradSer Скилл refactor-project для Claude Code, Codex, Cursor и других агентов запускает автоматический рефакторинг сразу по всем файлам проекта. Находит дубли, выравнивает стиль и убирает устаревший код за один прогон. CX Codex +1 122установок refactor-clean Affaan Mustafa Команда refactor-clean находит неиспользуемый код, генерирует отчёт и удаляет его с проверкой тестов. Перед каждым изменением запускает полный набор тестов, откатывает, если что-то сломалось. CX Codex +1 ★ 6 739звёзд репо refactor официальный github Скилл refactor для GitHub Copilot меняет структуру существующего кода без изменения его поведения. Помогает убирать дублирование, сложные функции и кодовые запахи. CX Codex +1 22 321установок oma-refactor First Fluke Скилл oma-refactor для Claude Code и Codex перестраивает структуру кода без изменений в его наблюдаемом поведении. Проводит точечный рефакторинг техдолга и горячих точек через мелкие проверенные шаги. CX Codex +1 ★ 1 472звёзд репо refactor-engineer First Fluke Субагент refactor-engineer, который переделывает код, сохраняя его функциональность. Помогает упростить сложные участки, подстраховывая каждый шаг тестами. CX Codex ★ 1 472звёзд репо agent-md-refactor softaworks Плагин agent-md-refactor для Claude Code разбивает монолитные файлы инструкций для ИИ на связанные документы. Упорядочивает AGENTS.md и CLAUDE.md. ★ 2 707звёзд репо

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

Весь набор →
file-operations Скилл file-operations собирает метаданные файлов, считает строки и находит крупные файлы без изменения исходного кода проекта. CX Codex +1 418установок code-auditor Скилл code-auditor для Claude Code разбирает репозиторий по шести направлениям: архитектура, качество кода, безопасность, производительность, тесты и поддерживаемость. Выявляет, что в кодовой базе болит. CX Codex +1 344установок dashboard-creator Скилл dashboard-creator для Claude Code собирает одностраничный HTML-дашборд: карточки KPI, графики, прогресс-бары и таблицы — без фронтенд-фреймворка. CX Codex +1 337установок timeline-creator Скилл timeline-creator для Claude Code собирает интерактивный HTML-таймлайн проекта с диаграммой Ганта, фазами и вехами. Показывает план на кварталы в одном файле. CX Codex +1 337установок feature-planning Скилл feature-planning превращает запрос на новую функцию или сложное изменение в пошаговый план с задачами, файлами и проверками. Пригодится до начала реализации. CX Codex +1 297установок code-execution Скилл code-execution для Claude Code запускает Python локально для массовых операций с файлами, анализа кода и Git. Выполняет большие многошаговые задачи. CX Codex +1 294установок conversation-analyzer Скилл conversation-analyzer изучает локальную историю диалогов Claude Code, чтобы выявить повторяющиеся ошибки, однотипные запросы и пиковые часы продуктивности. CX Codex +1 249установок technical-doc-creator Скилл technical-doc-creator создаёт HTML-документацию для API и систем: с примерами кода, диаграммой архитектуры и пошаговыми сценариями. CX Codex +1 221установок

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

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