rsbuild-v2-upgrade — скилл для Claude Code: апгрейд Rsbuild 1.x на v2
Проводит проект с Rsbuild 1.x через миграцию на v2: зависимости, конфиг, сломанные опции. Пригодится, когда мажорное обновление иначе растянется на вечер.
npx skills add rstackjs/agent-skills --skill rsbuild-v2-upgrade -a claude-codeЧто делает rsbuild-v2-upgrade
Скилл разбирает текущую сборку по шагам. Сначала читает package.json, находит пакеты Rsbuild и плагины, затем ищет конфиг — обычно это rsbuild.config.(ts|js|mjs|cjs). Дальше сверяет проект с официальным гайдом v1 → v2 и составляет список ломающих изменений, которые его касаются: удалённые и переименованные опции, изменившиеся значения по умолчанию, новые API плагинов.
Обновление зависимостей идёт по двум линиям: @rsbuild/core поднимается до v2, плагины — командой npx taze major --include /rsbuild/ -w -r. После этого правки в конфиге и коде: убрать то, что в v2 больше не поддерживается, привести настройки к новым опциям. В конце — прогон сборки, dev-режима, тестов или проверки типов, с разбором предупреждений новой версии.
Источник истины здесь — официальный гайд, а не память модели, поэтому скилл открывает его перед планированием. Если в проекте плагин, которого в гайде нет, сверять его поведение придётся вручную: агент опирается на то, что описано в миграции.
Какие задачи решает
- поднять @rsbuild/core до v2 без пропущенных ломающих изменений
- найти в конфиге опции, которые в v2 удалили или переименовали
- обновить плагины Rsbuild до мажорных версий одной командой
- разобрать предупреждения и ошибки после смены версии
- прогнать сборку, dev и тесты после миграции
Примеры запросов агенту
- Обнови проект с Rsbuild 1.x до v2 и покажи, что сломается в конфиге
- Пройди по гайду миграции и составь список изменений для моего rsbuild.config.ts
- Подними @rsbuild/core до v2 и проверь сборку с тестами
Как установить rsbuild-v2-upgrade
1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rsbuild-v2-upgrade -a claude-code2Вручную: положить файлы
~/.claude/skills/rsbuild-v2-upgrade/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/rsbuild-v2-upgrade/
1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rsbuild-v2-upgrade -a codex2Вручную: положить файлы
.agents/skills/rsbuild-v2-upgrade/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rsbuild-v2-upgrade -a cursor2Вручную: положить файлы
.cursor/skills/rsbuild-v2-upgrade/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install rstackjs/agent-skills rsbuild-v2-upgrade2Вручную: положить файлы
.github/skills/rsbuild-v2-upgrade/SKILL.md1Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rsbuild-v2-upgrade -a gemini-cli2Командой платформы
gemini skills install https://github.com/rstackjs/agent-skills --path skills/rsbuild-v2-upgradeВручную: положить файлы
.devin/skills/rsbuild-v2-upgrade/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add rstackjs/agent-skills --skill rsbuild-v2-upgrade -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора9
Похожие
Рядом в теме «Фронтенд и UI»
Всё по теме «Фронтенд и UI» →Вопросы о rsbuild-v2-upgrade
Как установить rsbuild-v2-upgrade в Claude?
Выполните npx skills add rstackjs/agent-skills --skill rsbuild-v2-upgrade -a claude-code. Файл скилла окажется в ~/.claude/skills/rsbuild-v2-upgrade/SKILL.md.
Что делает rsbuild-v2-upgrade?
Ведёт проект через миграцию Rsbuild с 1.x на v2: читает package.json и конфиг, сверяется с официальным гайдом, обновляет зависимости и правит настройки, а потом проверяет сборку и тесты.
Чем этот скилл отличается от обычного вопроса модели про Rsbuild v2?
Он берёт за источник истины официальный гайд v1 → v2 и идёт по шагам от текущего конфига проекта, а не отвечает по общим воспоминаниям о библиотеке.
Исходный текст
SKILL.md · MIT
---
name: rsbuild-v2-upgrade
description: Use when upgrading a Rsbuild 1.x project to v2, including dependency and configuration updates.
---
# Rsbuild v1 to v2 upgrade
## Workflow
1. **Confirm current setup**
- Read `package.json` to identify Rsbuild and plugin packages in use.
- Locate the Rsbuild config file (commonly `rsbuild.config.(ts|js|mjs|cjs)`).
2. **Open the official upgrade guide**
- Use the v1 → v2 guide as the source of truth:
- https://rsbuild.rs/guide/upgrade/v1-to-v2
3. **Plan the upgrade path**
- 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**
- Bump `@rsbuild/core` to v2
- Bump Rsbuild plugins to latest versions via `npx taze major --include /rsbuild/ -w -r`
5. **Apply config and code changes**
- Update the Rsbuild config to match v2 options and defaults.
- Remove deprecated or unsupported settings.
6. **Validate**
- Run the 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
