该技能用于把现有 Create React App 项目迁移到 Next.js，目标是在迁移完成后应用行为与迁移前保持一致。
用途：迁移 CRA 应用；将 React Router 路由改为基于文件的路由；在客户端为主的应用中引入 Server Components；从客户端渲染转向 SSR/SSG；更新环境变量；使用 Next.js 内置的图片与字体优化。
版本要求：使用 Next.js 16.x 或更高版本，明确不使用 14.x 或 15.x。迁移前可运行 npm info next version 查看当前最新版本，package.json 中最低支持 ^16.0.0。
规则按优先级分 17 类，共 148 条：项目设置（setup，6 条，关键）、依赖（deps，1 条，关键）、路由（routing，17 条，关键）、数据获取（data，11 条，关键）、组件（components，9 条，高）、环境变量（env，6 条，高）、样式（styling，12 条，高）、公共资源（assets，5 条，中）、图片（images，8 条，中）、字体（fonts，6 条，中）、SEO 与元数据（seo，9 条，中）、API 路由（api，9 条，中）、状态管理（state，8 条，中）、集成（integrations，1 条，中）、测试（testing，9 条，低）、构建与部署（build，7 条，低）、常见陷阱（gotchas，24 条，高）。
使用方式：先扫描代码库识别需特殊处理的模式，例如检查 WebSocket 库、SCSS 的 :export 语法、SVG 的 ReactComponent 导入、REACT_APP_ 环境变量、extraReducers 写法及 /app/ 路径等，再按“扫描结果到规则”的映射表读取对应规则。逐条阅读规则文件（如 rules/setup-initial-structure.md、rules/routing-basic-pages.md、rules/data-useeffect-to-rsc.md），每条包含说明、CRA 前后对比代码与注意事项。推荐迁移顺序为：设置、路由、环境变量、组件、数据获取、样式、图片与字体、SEO、API 路由、测试。
限制与注意事项：资料未提供收费、价格、平台与效果信息。迁移后需自行验证核心功能、客户端特性、路由、实时功能、集成、PWA 与性能，避免 hydration 不匹配等问题。本技能仅提供指南，不代替实际代码修改。