关于 migrate-to-rsbuild
用于将 webpack、Vite、CRA/CRACO 或 Vue CLI 项目迁移到 Rsbuild 的技能,面向开发者提供最小化配置变更、行为验证及后续清理步骤。
主要功能
- 01根据项目文件识别源框架
- 02应用框架专属迁移指南
- 03检查启动与构建行为
- 04验证通过后再清理旧配置
适用场景
- 01将 webpack 项目迁移到 Rsbuild
- 02将 Vite 或 CRA/CRACO 项目迁移到 Rsbuild
- 03替换 Vue CLI 并尽量保留现有行为
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ rstackjs/ agent-skills --skill migrate-to-rsbuild安装后在 Claude Code 中输入/migrate-to-rsbuild确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/cra.mdvite.mdvue-cli.mdwebpack.md详细介绍
迁移到 Rsbuild
目标
以最小的行为变化和清晰的验证流程,将 webpack、Vite、create-react-app(CRA/CRACO)或 Vue CLI 项目迁移到 Rsbuild。
支持的源框架
- webpack
- Vite
- CRA / CRACO
- Vue CLI
迁移原则(必须遵循)
- 优先遵循官方指南:以 Rsbuild 迁移文档为准。
- 优先进行最小改动:先完成基础迁移,再迁移自定义行为。
- 不要更改业务逻辑:除非用户明确要求,否则避免改动应用运行时代码。
- 验证后再清理:如有需要,暂时保留旧工具的依赖和配置;只有 Rsbuild 验证通过后才能移除。
工作流
-
检测源框架
- 检查
package.json中的依赖和脚本,以及配置文件:- webpack:
webpack.config.* - Vite:
vite.config.* - CRA/CRACO:
react-scripts、@craco/craco、craco.config.* - Vue CLI:
@vue/cli-service、vue.config.*
- webpack:
- 检查
-
应用特定框架的差异
- webpack:
references/webpack.md - Vite:
references/vite.md - CRA/CRACO:
references/cra.md - Vue CLI:
references/vue-cli.md
- webpack:
-
验证行为
- 运行开发服务器,确认项目启动时没有错误。
- 运行构建命令,确认项目构建成功。
- 如果仍有问题,请对照旧项目配置和迁移指南,补齐遗漏的配置映射。
-
清理并总结
- 只有验证通过后才能移除过时的依赖和配置。
- 总结已更改的文件以及仍需手动处理的事项。
评论
支持 Markdown