migrate-to-vinext

migrate-to-vinext 技能為開發人員提供自動化的遷移助手，旨在將現有的 Next.js 應用程式轉換至 vinext，這是一個基於 Vite 重新實作 Next.js API 介面的框架。此代理程式透過處理框架替換、設定檔更新與建置工具協調等繁重任務，簡化了網路專案的現代化進程，無需對應用程式邏輯進行手動修改。它旨在與現有的 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 環境中測試並驗證應用程式效能。