# safe-rename

Скилл safe-rename для Claude Code ведёт по безопасному переименованию экспортированных символов и файлов без поломки зависимостей и тестов.

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

## Что делает

Скилл ведёт агента по семи шагам переименования функций, классов, интерфейсов или файлов в кодовой базе. На этапе анализа вызываются `repo_map` и `symbols`, чтобы выявить всех импортёров и оценить радиус изменений. Затем правки вносятся по одной через `suggest_patch` и `apply_patch`, исключая пакетную замену вслепую.

Процесс требует обязательной валидации: после правок запускается `build_check` в режиме проверки типов и тесты через `test_runner`. Отдельное внимание уделено циклическим зависимостям при выносе общих типов в соседние файлы.

Для работы скилла в окружении должны быть доступны вспомогательные инструменты вроде `repo_map`, `batch_symbols` и `build_check`. Локальные переменные внутри одной функции им переименовывать не стоит — для этого хватает средств редактора.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill safe-rename -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill safe-rename -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill safe-rename -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ZaxbyHub/opencode-swarm .opencode/skills/generated/safe-rename
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill safe-rename -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .opencode/skills/generated/safe-rename
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill safe-rename -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.opencode/skills/generated/safe-rename/SKILL.md

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

## Примеры запросов агенту
- Переименуй экспортированный класс UserSession в AuthSession во всём проекте
- Переименуй файл src/utils/format.ts и обнови все связанные импорты
- Найди всех потребителей функции calculateTax и подготовь патчи для переименования

## Похожие
- [lsp-rename](https://affpapa.org/nevibecode/skills/lsp-rename.md) — скилл · ★ 182 у репозитория
- [lint-and-validate](https://affpapa.org/nevibecode/skills/sickn33-lint-and-validate.md) — скилл · 1300 установок
- [agent-sdk-verifier-ts](https://affpapa.org/nevibecode/agents/agent-sdk-verifier-ts.md) — субагент · ★ 47914 у репозитория
- [typescript](https://affpapa.org/nevibecode/skills/typescript.md) — скилл · 5200 установок
- [safe-refactor](https://affpapa.org/nevibecode/skills/safe-refactor.md) — скилл · 130700 установок
- [lsp-safe-edit](https://affpapa.org/nevibecode/skills/lsp-safe-edit.md) — скилл · ★ 182 у репозитория

Из того же набора: [zaxbyhub/opencode-swarm](https://affpapa.org/nevibecode/by/zaxbyhub/opencode-swarm.md) — 121 карточка

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

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