mcpField
N
next-upgrade

next-upgrade

github.com/kokonut-labs开发2.3k51 次安装2 天前更新
代码仓库

关于 next-upgrade

next-upgrade 是用于将现有 Next.js 项目升级到最新版本的技能，依据官方迁移指南确定步骤，涵盖代码转换、依赖更新与升级测试。

主要功能

  1. 01检测 Next.js 及相关依赖版本
  2. 02选择对应版本的迁移步骤
  3. 03运行代码转换工具处理破坏性变更
  4. 04更新依赖和 TypeScript 类型
  5. 05检查构建并运行开发应用

适用场景

  1. 01规划跨多个主版本的升级路径
  2. 02自动迁移受支持的 API
  3. 03检查配置与 API 的破坏性变更
  4. 04测试升级后的 Next.js 项目

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/kokonut-labs/kokonutui --skill next-upgrade

安装后在 Claude Code 中输入/next-upgrade确认已加载。

详细介绍

升级 Next.js

按照官方迁移指南，将当前项目升级到最新版本的 Next.js。

说明

  1. 检测当前版本：读取 package.json，确定当前 Next.js 版本及相关依赖项（React、React DOM 等）

  2. 获取最新升级指南：使用 WebFetch 获取官方升级文档：

  3. 确定升级路径：根据当前版本确定适用的迁移步骤。跨越多个主版本时，请逐步升级（例如，13 → 14 → 15）。

  4. 先运行 codemods：Next.js 提供 codemods，可自动处理破坏性变更：

    npx @next/codemod@latest <transform> <path>

    常见转换：

    • next-async-request-api - 更新异步 Request API（v15）
    • next-request-geo-ip - 迁移 geo/ip 属性（v15）
    • next-dynamic-access-named-export - 转换动态导入（v15）

  5. 更新依赖项：同时升级 Next.js 和对等依赖项：

    npm install next@latest react@latest react-dom@latest

  6. 检查破坏性变更：查看升级指南，了解需要手动进行的更改：

    • API 变更（例如，v15 中的异步 params）
    • next.config.js 中的配置变更
    • 将被移除的弃用功能

  7. 更新 TypeScript 类型（如适用）：

    npm install @types/react@latest @types/react-dom@latest

  8. 测试升级：

    • 运行 npm run build，检查构建错误
    • 运行 npm run dev 并测试关键功能

评论

支持 Markdown