# refactoring-code

Скилл refactoring-code для Claude Code ведёт упрощающий рефакторинг: сначала согласует план, затем вносит правки и проверяет, что поведение кода не изменилось.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 124 установки · ★ 3 у репозитория
- Автор: b-mendoza
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/b-mendoza/agent-skills/tree/HEAD/skills/refactoring-code/SKILL.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/refactoring-code

## Что делает

Скилл ведёт упрощающий рефакторинг так, чтобы поведение кода осталось прежним. Сначала план, потом правки: до утверждения плана ничего не меняется. За один прогон берётся один целевой файл, а сырой код и диффы остаются в субагентах — наружу уходят короткие отчёты.

Внутри четыре субагента: `behavior-mapper` снимает baseline и список рискованных мест, `chunk-analyst` разбирает один аспект анализа, `refactor-implementer` вносит одобренный план, `refactor-reviewer` выносит два вердикта про сохранение поведения и результат упрощения. План сверяется с `references/simplification-heuristics.md`, границы задаёт `references/protected-surfaces.md`, отчёты складываются в `.handoffs/refactoring-code/`. Из входов обязателен только `TARGET_PATH`, а `MAX_LINES` по умолчанию 250.

\`AUTO_APPROVE=true` проверки не отключает: карточка плана принимается сама только когда в ней нет превышения размера, небезопасной команды валидации и обхода защищённых поверхностей. Иначе прогон заканчивается статусом `NEEDS_CLARIFICATION`. Защищённая поверхность это жёсткий стоп, а повторное согласование расширенного объёма правок при `AUTO_APPROVE` всегда даёт `BLOCKED`.

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill refactoring-code -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill refactoring-code -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install b-mendoza/agent-skills skills/refactoring-code
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill refactoring-code -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill refactoring-code -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- Упрости `src/billing/invoice.ts`, поведение не меняй, тесты: `npm test -- invoice`
- Разбей `src/api/router.ts` на части, лимит 300 строк, защищённые поверхности не трогай
- Посмотри, есть ли что упростить в `src/queue/worker.ts`, но правок пока не делай

## Похожие
- [refactoring](https://affpapa.org/nevibecode/skills/refactoring.md) — скилл · 670 установок
- [refactoring-analysis](https://affpapa.org/nevibecode/skills/refactoring-analysis.md) — скилл · 434 установки
- [code-refactoring-tech-debt](https://affpapa.org/nevibecode/skills/code-refactoring-tech-debt.md) — скилл · 2 установки
- [refactoring_specialist](https://affpapa.org/nevibecode/agents/agenticorglab-refactoring-specialist.md) — субагент · ★ 776 у репозитория
- [do-in-parallel](https://affpapa.org/nevibecode/skills/do-in-parallel.md) — скилл · 1300 установок
- [refactoring-specialist](https://affpapa.org/nevibecode/skills/refactoring-specialist.md) — скилл · 757 установок

Из того же набора: [b-mendoza/agent-skills](https://affpapa.org/nevibecode/by/b-mendoza/agent-skills.md) — 12 карточек

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