# codebase-refactoring

Скилл запускает аудит кодовой базы через утилиту jscpd. Помогает пошагово сократить дублирование, вычистить мёртвый код и упростить перегруженные файлы.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 613 установок · ★ 6451
- Автор: kucherenko
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/kucherenko/jscpd/tree/HEAD/skills/codebase-refactoring/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/codebase-refactoring

## Что делает

Скилл организует трёхэтапную очистку проекта с помощью утилиты `jscpd`. Сначала запускается расчёт общего индекса здоровья через команду `npx jscpd --health --reporters ai <path>`. Метрика оценивает объём дублирования, неиспользуемый код и сложность логики. Максимальный балл — 100.

Анализ неиспользуемого кода работает через обход графа от входных точек вроде `package.json` или `pyproject.toml`. Поддерживаются JavaScript, TypeScript, JSX, TSX, Vue, Svelte, Astro и Python. Поиск делит находки на четыре типа: `unused-file`, `unused-export`, `unused-symbol` и `unused-import`. Каждая запись получает оценку уверенности от 0 до 100.

Если в проекте нет JavaScript, TypeScript или Python, поиск мёртвого кода ничего не покажет, поэтому этот шаг придётся пропустить. На этапе проверки сложности утилита находит самые запутанные ветвления и длинные файлы для последующего упрощения.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add kucherenko/jscpd --skill codebase-refactoring -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add kucherenko/jscpd --skill codebase-refactoring -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add kucherenko/jscpd --skill codebase-refactoring -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install kucherenko/jscpd codebase-refactoring
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add kucherenko/jscpd --skill codebase-refactoring -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add kucherenko/jscpd --skill codebase-refactoring -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- Проведи аудит и рефакторинг кодовой базы с помощью jscpd
- Найди мёртвый код в проекте и удали неиспользуемые экспорты
- Покажи самые сложные и запутанные файлы через jscpd

## Похожие
- [refactoring-patterns](https://affpapa.org/nevibecode/skills/refactoring-patterns.md) — скилл · 6300 установок
- [refactoring-specialist](https://affpapa.org/nevibecode/skills/refactoring-specialist.md) — скилл · 747 установок
- [vanity-engineering-review](https://affpapa.org/nevibecode/skills/vanity-engineering-review.md) — скилл · 3200 установок
- [fallow](https://affpapa.org/nevibecode/skills/fallow.md) — скилл · 9600 установок
- [refactor-safely](https://affpapa.org/nevibecode/skills/refactor-safely.md) — скилл · 1100 установок
- [vulture-dead-code](https://affpapa.org/nevibecode/skills/vulture-dead-code.md) — скилл · 311 установок

Из того же набора: [kucherenko/jscpd](https://affpapa.org/nevibecode/by/kucherenko/jscpd.md) — 3 карточки

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

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