rspress-v2-upgrade — скилл для Claude Code: миграция с v1 на v2
Скилл rspress-v2-upgrade автоматизирует переход Rspress-проекта с версии 1 на версию 2. Читает конфиг, обновляет зависимости, меняет импорты и валидирует результат по официальному гайду.
MIT 150 установок ★ 100 обновлён 2026-10-22
npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/rspress-v2-upgrade/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rspress-v2-upgrade/
1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a codex2Вручную: положить файлы
.agents/skills/rspress-v2-upgrade/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a cursor2Вручную: положить файлы
.cursor/skills/rspress-v2-upgrade/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rstackjs/agent-skills skills/rspress-v2-upgrade2Вручную: положить файлы
.github/skills/rspress-v2-upgrade/SKILL.md1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a gemini-cli2Командой платформы
gemini skills install https://github.com/rstackjs/agent-skills --path skills/rspress-v2-upgradeВручную: положить файлы
.devin/skills/rspress-v2-upgrade/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspress-v2-upgrade -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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