# refactor

Скилл refactor для Claude Code выполняет рефакторинг нескольких файлов с автооткатом через Git, проверкой типов и тестами до и после правок.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 937 у репозитория
- Автор: SethGammon
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/SethGammon/Citadel/tree/HEAD/skills/refactor/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/sethgammon-refactor

## Что делает

Скилл проводит структурные изменения кодовой базы по строгому протоколу. Сначала он фиксирует базовое состояние: запускает проверку типов через `npm run typecheck` и выполняет тесты проекта. Если в коде уже есть ошибки типизации, скилл сразу остановит работу до их ручного исправления. Затем агент строит детальный план с поиском всех импортов и мест вызова.

Правки вносятся по очереди: сначала создаются новые файлы, затем обновляются ссылки на них, меняется исходный модуль и только в конце удаляются старые файлы. Такой порядок снижает риск поломки сборки на промежуточных шагах. Если после изменений появляются новые ошибки, скилл делает две попытки их исправить. При неудаче он откатывает всё дерево через `git checkout`.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add SethGammon/Citadel
```
В чате агента (не в терминале):
```text
/plugin install citadel@citadel-local
```
Команда ставит плагин citadel целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add SethGammon/Citadel --skill refactor -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/refactor/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/refactor/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SethGammon/Citadel --skill refactor -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/refactor/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SethGammon/Citadel --skill refactor -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/refactor/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install SethGammon/Citadel skills/refactor
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/refactor/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add SethGammon/Citadel --skill refactor -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/SethGammon/Citadel --path skills/refactor
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/refactor/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/SethGammon/Citadel/tree/HEAD/skills/refactor/SKILL.md

## Когда брать
- переименовать символ или модуль по всему проекту с обновлением путей
- вынести компонент или функцию в отдельный файл
- разбить разросшийся файл на логические части
- встроить инлайном модуль обратно в места вызова

## Примеры запросов агенту
- /refactor extract UserService from src/services/api.ts
- /refactor rename OldButton to PrimaryButton
- /refactor --dry-run split src/utils/helpers.ts

## Похожие
- [refactor-guided](https://affpapa.org/nevibecode/commands/refactor-guided.md) — команда · ★ 1424 у репозитория
- [refactor-clean](https://affpapa.org/nevibecode/commands/sangrokjung-refactor-clean.md) — команда · ★ 880 у репозитория
- [refactor-plan](https://affpapa.org/nevibecode/skills/refactor-plan.md) — скилл · 12965 установок
- [review-and-refactor](https://affpapa.org/nevibecode/skills/review-and-refactor.md) — скилл · 11056 установок
- [w-refactor](https://affpapa.org/nevibecode/skills/w-refactor.md) — скилл · 647 установок
- [refactor-legacy-code](https://affpapa.org/nevibecode/skills/refactor-legacy-code.md) — скилл · 611 установок

## Другие версии с тем же именем
- [refactor · github](https://affpapa.org/nevibecode/skills/refactor.md) — 22321 установка
- [refactor · parcadei](https://affpapa.org/nevibecode/skills/parcadei-refactor.md) — 625 установок
- [refactor · smallnest](https://affpapa.org/nevibecode/skills/smallnest-refactor.md) — 538 установок
- [refactor · boshu2](https://affpapa.org/nevibecode/skills/boshu2-refactor.md) — 123 установки
- [refactor · pproenca](https://affpapa.org/nevibecode/skills/pproenca-refactor.md) — 661 установка

Из того же набора: [sethgammon/citadel](https://affpapa.org/nevibecode/by/sethgammon/citadel.md) — 55 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
