项目迁移与框架升级
Vue 2→3、Express→Fastify、Webpack→Vite —— OpenClaw 帮你平滑迁移，不用手动踩坑
迁移这件事，谁做谁知道
升级一个框架，踩一百个坑
Vue 2 要升 Vue 3 了。你打开迁移指南，200 多页。Options API 要改 Composition API，Vuex 要换 Pinia，Vue Router 语法也变了 —— 好，改。
改完发现第三方组件库不兼容了。换了新的组件库，发现样式全乱了。修完样式，跑测试，一半红的。这还只是前端，后端的 Python 2 转 3 也在排期呢……
最惨的是，老板问「这周能搞完吗？」
OpenClaw：先分析差异，再逐步迁移
把旧项目丢给 OpenClaw，它会：
1. 扫描所有文件，列出需要改的地方
2. 按优先级排序：先改破坏性变更，再改废弃 API
3. 逐文件生成改后的代码，附上每处改动的解释
4. 标出不兼容的第三方依赖，给出替代方案
你不用一页页看迁移指南了。OpenClaw 已经读过了，而且它知道你的项目里具体哪些地方需要改。
3 条迁移 Prompt，覆盖主流场景
前端框架、后端框架、构建工具，各来一条。
Vue 2 → Vue 3 Composition API 迁移
黄金指令
请将这个 Vue 2 项目升级到 Vue 3，要求：
1. 将所有 Options API 组件改写为 Composition API（script setup 语法）
2. Vuex 状态管理迁移到 Pinia
3. Vue Router 3 升级到 Vue Router 4（注意路由守卫语法变化）
4. 处理 $listeners、$attrs、filter 等已移除的 API
5. 检查 Element UI → Element Plus（或其他组件库）的兼容性
按文件输出修改内容，每个改动说明原因。
最后列出需要手动确认的第三方依赖兼容性问题。Vue 2 → 3 是最常见的前端迁移场景。建议用 Claude Opus 4.6，它对 Vue 生态的理解比较准确。大项目按模块分批迁移效果更好。
Express.js → Fastify 迁移
进阶技巧
请将这个 Express.js 应用迁移到 Fastify 框架：
1. 路由迁移：Express 的 router 改为 Fastify 的路由注册方式
2. 中间件迁移：
- body-parser → Fastify 内置
- cors → @fastify/cors
- helmet → @fastify/helmet
- 自定义中间件 → Fastify hooks (onRequest / preHandler)
3. 错误处理：Express 的 error middleware → Fastify setErrorHandler
4. 请求/响应对象：req.body / res.json 等 API 差异处理
5. 验证：joi / express-validator → Fastify 内置 JSON Schema 验证
保持所有现有 API 接口不变，确保前端无感切换。Express → Fastify 性能提升明显（通常 2-3 倍），但中间件迁移是重点。这条 Prompt 覆盖了最常用的中间件对应关系。
Webpack → Vite 迁移
新手友好
请帮我把这个 Webpack 项目迁移到 Vite：
1. 创建 vite.config.ts，对应现有 webpack.config.js 的配置
2. 处理以下常见差异：
- require() → import
- process.env → import.meta.env
- CSS modules / SCSS 配置
- 别名（alias）配置
- 代理（proxy）配置
3. 检查不兼容的 Webpack loader，推荐 Vite 插件替代
4. 更新 package.json scripts
5. 处理 CommonJS 依赖的兼容问题
给出迁移后的配置文件和需要修改的源文件清单。Webpack → Vite 迁移相对简单，主要是配置迁移。标记为 beginner 是因为大部分改动比较机械，AI 处理起来很稳。
迁移前的准备配置
在让 OpenClaw 帮你迁移之前，最好先把项目信息整理好。
项目迁移上下文模板
# 项目迁移信息
## 当前技术栈
- 框架: Vue 2.7 + Vuex 3 + Vue Router 3
- 构建工具: Webpack 4
- UI 组件库: Element UI 2.x
- Node 版本: 16.x
## 目标技术栈
- 框架: Vue 3.4 + Pinia + Vue Router 4
- 构建工具: Vite 5
- UI 组件库: Element Plus 2.x
- Node 版本: 20.x
## 项目规模
- 组件数量: ~80 个
- 页面数量: ~30 个
- 自定义指令: 5 个
- 自定义 filter: 8 个
## 已知问题
- xxx 组件库暂无 Vue 3 版本
- 部分代码使用了 this.$refs 直接操作 DOMOpenClaw 迁移 vs 手动迁移
OpenClaw 辅助迁移
- 自动扫描所有需要改的地方，不会遗漏
- 按文件生成修改后的代码，复制粘贴就行
- 能解释每处改动的原因，相当于自带迁移文档
- 遇到不兼容的第三方库会主动提醒并推荐替代
- 大项目几天搞定，小项目几小时搞定
VS
纯手动迁移
- 要从头读完官方迁移指南（通常几百页）
- 逐文件人工查找和修改，容易漏改
- 遇到问题全靠 Google 和 Stack Overflow
- 第三方库兼容性问题只有跑起来才知道
- 大项目可能要改几周，中途各种意外
迁移小贴士
大项目迁移千万别一口气全改。按模块分批迁移，每批改完跑一遍测试，确认没问题再继续下一批。
迁移前一定要确保有完整的测试覆盖。如果现有测试不够，先让 OpenClaw 帮你补测试，再开始迁移 —— 这个顺序很重要。