AI Skill 大全

Next.js 版本升级

给出现有 Next.js 项目的 package.json,产出到目标版本的升级路径、codemod 命令与破坏性变更核对清单。

功能与用途

Next.js 大版本升级时的坑集中在异步 params、废弃 API 和配置文件改动上。这个能力先读 package.json 定位当前版本,再去官方升级文档和 codemod 页面确认路径,跑 npx @next/codemod 自动改造,最后同步 React 与类型依赖并跑 build 验证。跨多个大版本时会按 13→14→15 这样逐级升。

适用场景

  • 大版本升级前置评估:检查 package.json 依赖与破坏性变更,规划从旧版本逐级升级至目标版本的安全路径。
  • 批量自动化 Codemod 改造:运行官方 codemod 自动迁移异步请求 API、动态导入和废弃配置,减少手工修改。
  • 升级后构建与类型校验排障:同步升级 React 与相关类型包,运行生产构建并定位异步 params 等改动引发的报错。

适用人群

  • 维护 Next.js 项目的全栈开发
  • 负责框架升级的技术负责人
  • 要处理遗留 Pages Router 迁移的前端工程师

使用步骤

  1. 把 package.json 发过去,让它先确认当前 Next.js、React、React DOM 版本
  2. 确认升级路径:是直接跳到最新版,还是按大版本逐级升
  3. 跑对应的 codemod,如 npx @next/codemod@latest next-async-request-api ./
  4. 一并升级 next、react、react-dom 与 @types 依赖,再核对破坏性变更清单
  5. 跑 npm run build 和 npm run dev 验证,确认关键功能正常

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
进阶
版本
main
最近更新
2026-09-18
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

Upgrade Next.js to the latest version following official migration guides and codemods. Use when upgrading Next.js versions, running codemods, or migrating between major releases.

使用前准备

  • 一个已有的 Next.js 项目仓库,能执行 npm/npx 命令并可访问 nextjs.org 官方升级文档

依赖与权限

  • 读取用户主动提供的内容

同类 Skill