mcpField
M
migrate-to-rsbuild

migrate-to-rsbuild

github.com/rstackjs开发97329 次安装6 天前更新
代码仓库

关于 migrate-to-rsbuild

用于将 webpack、Vite、CRA/CRACO 或 Vue CLI 项目迁移到 Rsbuild 的技能,面向开发者提供最小化配置变更、行为验证及后续清理步骤。

主要功能

  1. 01根据项目文件识别源框架
  2. 02应用框架专属迁移指南
  3. 03检查启动与构建行为
  4. 04验证通过后再清理旧配置

适用场景

  1. 01将 webpack 项目迁移到 Rsbuild
  2. 02将 Vite 或 CRA/CRACO 项目迁移到 Rsbuild
  3. 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.md
vite.md
vue-cli.md
webpack.md

详细介绍

迁移到 Rsbuild

目标

以最小的行为变化和清晰的验证流程,将 webpack、Vite、create-react-app(CRA/CRACO)或 Vue CLI 项目迁移到 Rsbuild。

支持的源框架

  • webpack
  • Vite
  • CRA / CRACO
  • Vue CLI

迁移原则(必须遵循)

  1. 优先遵循官方指南:以 Rsbuild 迁移文档为准。
  2. 优先进行最小改动:先完成基础迁移,再迁移自定义行为。
  3. 不要更改业务逻辑:除非用户明确要求,否则避免改动应用运行时代码。
  4. 验证后再清理:如有需要,暂时保留旧工具的依赖和配置;只有 Rsbuild 验证通过后才能移除。

工作流

  1. 检测源框架

    • 检查 package.json 中的依赖和脚本,以及配置文件:
      • webpack:webpack.config.*
      • Vite:vite.config.*
      • CRA/CRACO:react-scripts、@craco/craco、craco.config.*
      • Vue CLI:@vue/cli-service、vue.config.*
  2. 应用特定框架的差异

    • webpack:references/webpack.md
    • Vite:references/vite.md
    • CRA/CRACO:references/cra.md
    • Vue CLI:references/vue-cli.md
  3. 验证行为

    • 运行开发服务器,确认项目启动时没有错误。
    • 运行构建命令,确认项目构建成功。
    • 如果仍有问题,请对照旧项目配置和迁移指南,补齐遗漏的配置映射。
  4. 清理并总结

    • 只有验证通过后才能移除过时的依赖和配置。
    • 总结已更改的文件以及仍需手动处理的事项。

评论

支持 Markdown