next-upgrade

next-upgrade 技能是一款工程自动化工具，专为简化更新 Next.js 项目的复杂流程而设计。此技能针对维护 Next.js 代码库的开发人员，减少处理框架主要版本间重大变更、依赖项更新及 API 调整所需的手动开销。通过与 Vercel 官方文档直接整合，确保您的项目保持安全、高效，并符合最新的框架标准。

• 自动化的依赖关系管理，将 next、react 及 react-dom 更新至最新的兼容版本。

• 执行官方 @next/codemod 脚本，自动重构源代码以适应重大变更，例如 Next.js 15 中转向异步请求 API (async Request APIs) 的过程。

• 增量升级路径计算，通过将流程分解为可管理的特定版本步骤，实现安全的跨版本升级 (例如 v13 到 v15)。

• 通过解析 package.json 探测当前项目状态，识别现有版本与核心依赖关系。

• 包含构建检查 (npm run build) 与开发服务器测试 (npm run dev) 的验证工作流程，确保升级不会导致网站功能倒退。

• 使用此技能时，建议保持干净的工作目录与版本控制 (git)，以便在自动迁移失败时轻松回退。

• 强烈建议手动审查 codemod 的执行结果，因为某些复杂的代码模式可能需要人为干预或微调。

• 技能会实时抓取 nextjs.org 的文档；请确保有互联网连接以获取最新的迁移指南。

• 在进行重大跨越时，建议采用增量升级而非跳过版本，以避免累积未处理的重大变更。

• 将此技能纳入您的定期维护周期，以避免累积『版本债务』，并确保与现代 React 功能及 Next.js 优化模式的兼容性。