# rspress-v2-upgrade

Скилл rspress-v2-upgrade автоматизирует переход Rspress-проекта с версии 1 на версию 2. Читает конфиг, обновляет зависимости, меняет импорты и валидирует результат по официальному гайду.

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

## Что делает

Скилл проходит по чек-листу миграции: сначала смотрит `package.json` и конфиг Rspress, затем заменяет старые пакеты на `@rspress/core@^2.0.0`, удаляет встроенные в v2 плагины (`@rspress/plugin-shiki`, `@rspress/plugin-auto-nav-sidebar` и другие), обновляет импорты (`rspress/runtime` → `@rspress/core/runtime`, `@rspress/theme-default` → `@rspress/core/theme-original`). Если в проекте кастомная тема, скилл подскажет использовать `@rspress/core/theme-original` для базовых компонентов.

Далее скилл переводит опции конфига на v2, запускает сборку и dev-сервер, ловит ошибки. Требует Node.js >= 20.9.0 — без этого обновление не пойдёт. Если что-то сломается, скилл указывает на [официальный гайд миграции](https://rspress.rs/guide/migration/rspress-1-x) и просит проверить пропущенные шаги.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rstackjs/agent-skills skills/rspress-v2-upgrade
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/rstackjs/agent-skills --path skills/rspress-v2-upgrade
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a opencode
```

### Claude.ai

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

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

## Когда брать
- обновить Rspress с v1 на v2 в действующем проекте
- заменить старые импорты на новые пути в коде и конфиге
- удалить пакеты, встроенные в @rspress/core
- переписать конфиг под v2 и отловить несовместимости
- валидировать результат сборки и dev-сервера

## Примеры запросов агенту
- Помоги мне обновить Rspress с v1 на v2
- Мигрирую проект Rspress со старой версии, что менять в конфиге?
- Какие пакеты удалить при переходе на rspress v2?

## Похожие
- [prisma-upgrade-v7](https://affpapa.org/nevibecode/skills/prisma-upgrade-v7.md) — скилл · 425400 установок
- [metabase-modular-embedding-to-modular-embedding-sdk-upgrade](https://affpapa.org/nevibecode/skills/metabase-modular-embedding-to-modular-embedding-sdk-upgrade.md) — скилл · 385 установок
- [react19-upgrade](https://affpapa.org/nevibecode/plugins/react19-upgrade.md) — плагин · ★ 41430 у репозитория
- [react18-upgrade](https://affpapa.org/nevibecode/plugins/react18-upgrade.md) — плагин · ★ 41430 у репозитория
- [play-billing-library-version-upgrade](https://affpapa.org/nevibecode/skills/play-billing-library-version-upgrade.md) — скилл · 2300 установок
- [netsuite-suitescript-upgrade](https://affpapa.org/nevibecode/skills/netsuite-suitescript-upgrade.md) — скилл · 910 установок

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

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

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