vue2-to-vue3-migration

name	vue2-to-vue3-migration
description	用于 ant-design-vue(Vue2) 到 ant-design-vue3(Vue3) 的页面、组件或模块迁移工作流。适用于单页迁移、批量迁移、迁移拆单、迁移验收、迁移风险盘点。 Use when this capability is needed.
metadata	{"author":"agoodays"}

Vue2 到 Vue3 迁移工作流

本技能用于本仓库前端迁移任务，目标是将 ant-design-vue 中的 Vue2 页面、组件或模块，逐步迁移到 ant-design-vue3/agpay-ui-manager。

何时使用

• 需要把单个 Vue2 页面迁移到 Vue3
• 需要批量盘点一个模块的迁移范围
• 需要为复杂页面生成分阶段 PR 计划
• 需要对已迁移页面做行为一致性验收
• 需要识别 Vue2 代码中的迁移阻塞点、公共依赖和高风险写法

迁移前规则

开始前必须先读取并遵循以下规则文件：

• .github/instructions/ant-design-vue-legacy-migration.instructions.md
• .github/instructions/ant-design-vue3-vite-guidelines.instructions.md
• .github/instructions/vue-script-setup-safety.instructions.md

决策流程

根据用户输入选择路径：

1. 用户要“直接迁移一个页面/组件”

• 执行单页迁移流程

2. 用户要“迁移一个目录、一个模块、多个页面”

• 执行批量迁移流程

3. 用户要“先规划，不立即改代码”

• 执行迁移拆单流程

4. 用户要“检查已迁移结果是否可合并”

• 执行迁移验收流程

若用户表达不清，先补全以下信息：

• 源 Vue2 路径
• 目标 Vue3 路径
• 是否要直接改代码，还是只出计划/验收

单页迁移流程

1. 定位源文件与目标落点

• 源目录通常在 ant-design-vue/agpay-ui-manager/src