vercel-labs/openreview

next-upgrade

Upgrade Next.js to the latest version following official migration guides and codemods

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/vercel-labs/openreview --skill next-upgrade

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Upgrade Next.js

Upgrade the current project to the latest Next.js version following official migration guides.

Instructions

  1. Detect current version: Read package.json to identify the current Next.js version and related dependencies (React, React DOM, etc.)
  1. Fetch the latest upgrade guide: Use WebFetch to get the official upgrade documentation:
  • Codemods: https://nextjs.org/docs/app/guides/upgrading/codemods
  • Version-specific guides (adjust version as needed):
  • https://nextjs.org/docs/app/guides/upgrading/version-16
  • https://nextjs.org/docs/app/guides/upgrading/version-15
  • https://nextjs.org/docs/app/guides/upgrading/version-14
  1. Determine upgrade path: Based on current version, identify which migration steps apply. For major version jumps, upgrade incrementally (e.g., 13 → 14 → 15).
  1. Run codemods first: Next.js provides codemods to automate breaking changes:
bash
   npx @next/codemod@latest <transform> <path>

Common transforms:

  • next-async-request-api - Updates async Request APIs (v15)
  • next-request-geo-ip - Migrates geo/ip properties (v15)
  • next-dynamic-access-named-export - Transforms dynamic imports (v15)
  1. Update dependencies: Upgrade Next.js and peer dependencies together:
bash
   npm install next@latest react@latest react-dom@latest
  1. Review breaking changes: Check the upgrade guide for manual changes needed:
  • API changes (e.g., async params in v15)
  • Configuration changes in next.config.js
  • Deprecated features being removed
  1. Update TypeScript types (if applicable):
bash
   npm install @types/react@latest @types/react-dom@latest
  1. Test the upgrade:
  • Run npm run build to check for build errors
  • Run npm run dev and test key functionality

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills