rspack-v2-upgrade — скилл для Claude Code: апгрейд Rspack 1.x на v2
Ведёт проект с Rspack 1.x через переход на вторую версию: зависимости, конфиг, проверка сборки. Пригодится, когда мажорный апгрейд страшно начинать вручную.
npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a claude-codeЧто делает rspack-v2-upgrade
Скилл разбирает апгрейд по шагам. Сначала читает package.json и находит конфиг Rspack — обычно это rspack.config.(ts|js|mjs|cjs). Дальше сверяет текущие настройки с официальным гайдом по миграции и выписывает, какие breaking changes касаются именно вашего проекта: удалённые и переименованные опции, изменившиеся значения по умолчанию, изменения в API плагинов.
Потом обновляются пакеты: @rspack/core, @rspack/cli, @rspack/dev-server, @rspack/plugin-react-refresh. Конфиг и связанный код правятся по гайду, устаревшие опции убираются. В конце — прогон сборки, dev-режима, тестов или проверки типов, и разбор предупреждений, которые всплыли на новой версии.
Единый источник правды здесь — официальный гайд миграции, а не догадки агента. Это важно: если в вашем конфиге есть кастомные плагины, сверяться придётся с их документацией, потому что гайд покрывает только ядро Rspack.
Какие задачи решает
- обновить Rspack 1.x до v2 без пропущенных breaking changes
- найти и убрать удалённые или переименованные опции в конфиге
- поднять версии
@rspack/core,@rspack/cliи dev-server согласованно - проверить сборку и тесты после мажорного апгрейда
- разобрать предупреждения, появившиеся на новой версии
Примеры запросов агенту
- Проведи апгрейд проекта с Rspack 1.x на v2 по официальному гайду миграции
- Сравни мой
rspack.config.tsс гайдом миграции и перечисли применимые breaking changes - Обнови пакеты Rspack до v2 и прогони сборку с тестами
Как установить rspack-v2-upgrade
1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a claude-code2Вручную: положить файлы
~/.claude/skills/rspack-v2-upgrade/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rspack-v2-upgrade/
1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a codex2Вручную: положить файлы
.agents/skills/rspack-v2-upgrade/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a cursor2Вручную: положить файлы
.cursor/skills/rspack-v2-upgrade/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rstackjs/agent-skills rspack-v2-upgrade2Вручную: положить файлы
.github/skills/rspack-v2-upgrade/SKILL.md1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a gemini-cli2Командой платформы
gemini skills install https://github.com/rstackjs/agent-skills --path skills/rspack-v2-upgradeВручную: положить файлы
.devin/skills/rspack-v2-upgrade/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора9
Похожие
Рядом в теме «Фронтенд и UI»
Всё по теме «Фронтенд и UI» →Вопросы о rspack-v2-upgrade
Как установить rspack-v2-upgrade в Claude?
Выполните npx skills add rstackjs/agent-skills --skill rspack-v2-upgrade -a claude-code. Скилл окажется в ~/.claude/skills/rspack-v2-upgrade/SKILL.md.
Что делает rspack-v2-upgrade?
Проводит проект через переход с Rspack 1.x на v2: находит конфиг, сверяет его с официальным гайдом миграции, обновляет пакеты и правит настройки, затем проверяет сборку и тесты.
На чём сломается апгрейд?
Официальный гайд описывает ядро Rspack. Кастомные плагины в конфиге придётся сверять с их собственной документацией — иначе часть изменений останется незамеченной.
Исходный текст
SKILL.md · MIT
---
name: rspack-v2-upgrade
description: Use when upgrading a Rspack 1.x project to v2, including dependency and configuration updates.
---
# Rspack 1.x to v2 upgrade
## Workflow
1. **Confirm current setup**
- Read `package.json` to identify Rspack packages in use.
- Locate the Rspack config file (commonly `rspack.config.(ts|js|mjs|cjs)`).
2. **Open the official migration guide**
- Use the official guide as the single source of truth:
- https://rspack.rs/guide/migration/rspack_1.x
3. **Plan required changes**
- Compare the current project config with the migration guide.
- List breaking changes that apply to the project’s current config and plugins.
- Note any removed or renamed options, defaults, or plugin APIs.
4. **Update dependencies**
- Upgrade Rspack packages to v2: `@rspack/core`, `@rspack/cli`, `@rspack/dev-server`, `@rspack/plugin-react-refresh`.
5. **Apply migration changes**
- Update the Rspack config and related code according to the official guide.
- Remove deprecated or unsupported options.
6. **Validate**
- Run build and dev commands.
- Run project tests or type checks.
- Fix any warnings or errors surfaced by the new version.
© rstackjs · MIT · rstackjs/agent-skills
