К основному содержанию
скилл CX Codex

rspress-v2-upgrade — скилл для Claude Code: миграция с v1 на v2

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

MIT 150 установок ★ 100 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a claude-code
Открыть на GitHub

Что делает 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) и просит проверить пропущенные шаги.

Какие задачи решает

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

Примеры запросов агенту

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

Как установить rspress-v2-upgrade

1Через Skills CLI (Vercel)

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/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о rspress-v2-upgrade

Как установить rspress-v2-upgrade в Claude Code?

Выполни npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a claude-code, затем открой файл ~/.claude/skills/rspress-v2-upgrade/SKILL.md.

Что делает rspress-v2-upgrade?

Скилл автоматизирует миграцию проекта Rspress с v1 на v2: обновляет зависимости, меняет импорты, переписывает конфиг и валидирует результат.

Какая версия Node.js нужна для v2?

Требуется Node.js >= 20.9.0. Если версия ниже, обновление не сработает.

Исходный текст

SKILL.md · MIT
---
name: rspress-v2-upgrade
description: Migrate Rspress projects from v1 to v2. Use when a user asks to upgrade Rspress, follow the v1-to-v2 guide, update configs/themes, or validate the upgrade.
---

# Rspress v1 to v2 upgrade

## Workflow

1. **Confirm current setup**
   - Read `package.json` to identify Rspress and plugin packages in use.
   - Locate the Rspress config file (commonly `rspress.config.(ts|js|mjs|cjs)`).
   - Check for custom theme files and MDX usage.

2. **Open the official upgrade guide**
   - Use the v1 → v2 guide as the source of truth:
     - <https://rspress.rs/guide/migration/rspress-1-x>

3. **Plan the upgrade path**
   - List breaking changes that apply to the project's current config, plugins, and theme.
   - Note any removed or renamed packages, options, and APIs.

4. **Update dependencies**
   - Replace `rspress` with `@rspress/core@^2.0.0`.
   - Remove packages now built into `@rspress/core` (e.g. `rspress`, `@rspress/plugin-shiki`, `@rspress/plugin-auto-nav-sidebar`, `@rspress/plugin-container-syntax`, `@rspress/plugin-last-updated`, `@rspress/plugin-medium-zoom`, `@rspress/theme-default`, `@rspress/runtime`).
   - Bump remaining Rspress plugins to latest versions via `npx taze major --include /rspress/ -w -r`.
   - Ensure Node.js >= 20.9.0.

5. **Apply config and code changes**
   - Update import paths (`rspress/runtime` → `@rspress/core/runtime`, `rspress/theme` → `@rspress/core/theme`, `@rspress/theme-default` → `@rspress/core/theme-original`).
   - If the project has a custom theme (in `theme` directory), use `@rspress/core/theme-original` to import the original theme components.
   - Update the Rspress config to match v2 options and defaults.
   - Remove deprecated or unsupported settings.

6. **Validate**
   - Run the build and dev server.
   - Fix any warnings or errors that appear in the new version. If errors or warnings occur, please refer to the [Official Upgrade Guide](https://rspress.rs/guide/migration/rspress-1-x) and first check if it's caused by any omitted or incomplete migration steps.

© rstackjs · MIT · rstackjs/agent-skills

Похожие скиллы

Все скиллы по теме «Фронтенд и UI» →
prisma-upgrade-v7 prisma Скилл prisma-upgrade-v7 для Claude Code описывает переход с Prisma ORM v6 на v7: генератор, драйверы, ESM-конфиг и импорты. Включают при обновлении Prisma или разборе ошибок v7. CX Codex +1 425 400установок metabase-modular-embedding-to-modular-embedding-sdk-upgrade metabase Скилл metabase-modular-embedding-to-modular-embedding-sdk-upgrade для Claude Code переносит React-проект с Metabase embed.js на @metabase/embedding-sdk-react при смене web components на React SDK. CX Codex +1 385установок react19-upgrade официальный Awesome Copilot Community Плагин react19-upgrade для GitHub Copilot помогает перенести проект с React 18 на React 19. Он подключается к задаче миграции и проводит её через проверку кода, обновление зависимостей и тестов. ★ 41 430звёзд репо react18-upgrade официальный Awesome Copilot Community Плагин react18-upgrade помогает перенести проект с React 16 или 17 на React 18.3.1: проверяет несовместимые API, обновляет зависимости, код компонентов и тесты. ★ 41 430звёзд репо play-billing-library-version-upgrade Google LLC Скилл play-billing-library-version-upgrade помогает перевести Android-проект с устаревшей Google Play Billing Library на актуальную стабильную версию. Разбирает исходный уровень API и планирует прямой или пошаговый переход. CX Codex +1 2 300установок netsuite-suitescript-upgrade Oracle NetSuite Скилл netsuite-suitescript-upgrade для Claude Code анализирует и переводит SuiteScript 1.0, 2.0 и 2.x на 2.1, затем проверяет результат. Переводит старые скрипты NetSuite. CX Codex +1 910установок

Из того же набора21

Весь набор →
migrate-to-rsbuild Скилл migrate-to-rsbuild переводит фронтенд-проекты с webpack, Vite, Create React App и Vue CLI на сборщик Rsbuild. Он пошагово заменяет конфигурацию и проверяет запуск перед удалением старых пакетов. CX Codex +1 342установок rspack-tracing Скилл rspack-tracing для Claude Code и других IDE захватывает и анализирует traces сборок Rspack, чтобы найти медленные фазы компилятора, плагины и лоадеры. Помогает диагностировать крахи и узкие места прямо в процессе разработки. CX Codex +1 291установок rspack-debugging Скилл rspack-debugging для Claude Code снимает через LLDB состояние краша нативного Rspack и собирает бэктрейсы при segfault, дедлоке или зависшей сборке. CX Codex +1 282установок storybook-rsbuild Скилл storybook-rsbuild настраивает Storybook на Rsbuild или переносит существующий проект с webpack и Vite. Он также учитывает интеграции с Rslib, Modern.js и Rspack. CX Codex +1 212установок migrate-to-rslib Скилл migrate-to-rslib переводит сборку библиотек с tsc или tsup на Rslib с проверкой билда и сохранением исходного кода. CX Codex +1 201установок rspack-split-chunks Скилл rspack-split-chunks помогает агенту диагностировать и настраивать optimization.splitChunks в Rspack: найти дубликаты модулей, избыточную загрузку, проблемы кеширования и слишком большие чанки. CX Codex +1 187установок rstest-debugging Скилл rstest-debugging помогает найти причину проблем Rstest со стартом, сборкой, рантаймом, логами, памятью и производительностью по трассам и сопоставимым замерам. CX Codex +1 133установок rslib-modern-package Скилл rslib-modern-package для Claude Code помогает создавать и проверять JS/TS-библиотеки на Rslib: от публичного API и зависимостей до готовности к публикации. Создаёт новые библиотеки и модернизирует существующие. CX Codex +1 125установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой