migrate-to-vinext

migrate-to-vinext 技能为开发人员提供自动化的迁移助手，旨在将现有的 Next.js 应用程序转换至 vinext，这是一个基于 Vite 重新实现 Next.js API 接口的框架。此代理程序通过处理框架替换、配置文件更新与构建工具协调等繁重任务，简化了 Web 项目的现代化进程，无需对应用程序逻辑进行手动修改。它旨在与现有的 App Router 或 Pages Router 项目无缝对接，确保您能在保留当前项目结构的同时，运用 Vite 的高性能开发服务器、热模块替换 (HMR) 与原生 ESM 支持。通过使用此技能，您可以减少项目重构的运维负担，最大限度地降低手动设置期间的配置错误风险，并立即获得更强大的构建性能与 Cloudflare 原生部署选项。

• 自动检测并验证现有的 Next.js 项目结构，包含 App Router 与 Pages Router 配置。

• 通过 vinext check 执行全面的兼容性扫描，在迁移开始前识别潜在障碍。

• 执行完整的项目迁移，包含依赖项重新映射、Vite 配置文件生成、ESM 转换以及 package.json 中的脚本更新。

• 通过自动生成必要配置文件（如 wrangler.jsonc），促进 Cloudflare Workers 的部署设置。

• 通过原生模块整合 Cloudflare 绑定（D1、R2、KV、AI），实现服务器端数据访问的简洁实现。

• 处理非破坏性的迁移流程，让您可以同时执行原始 Next.js 设置与新的 vinext 实现以进行测试。

• 当您希望从 Next.js 迁移、转换或切换至 vinext 时，请使用类似“migrate this project to vinext”的指令来触发技能。

• 技能采用分阶段流程：验证、兼容性检查、自动化迁移与部署优化。

• 确保您的项目 package.json 依赖项中包含 next，这是技能确认目标是否为有效 Next.js 项目的必要条件。

• 请注意，尽管支持核心功能，但对于涉及第三方函数库生态系统的边缘情况，建议查阅 vinext 仓库中的 references/compatibility.md。

• 自动迁移完成后，您可以使用 dev:vinext 或 build:vinext 脚本，在停用原始 Next.js 配置前，先在 Vite 环境中测试并验证应用程序性能。