next-upgrade
GitHub指导用户将 Next.js 项目升级至最新版本。通过检测当前版本、获取官方迁移指南和 Codemods，自动化处理依赖更新、破坏性变更及类型定义，确保平滑迁移并验证构建与运行状态。
Trigger Scenarios
Install
npx skills add fanfan-de/anybox --skill next-upgrade -g -y
SKILL.md
Frontmatter
{
"name": "next-upgrade",
"chainTo": [
{
"message": "Pages Router patterns detected during upgrade — loading Next.js best practices for App Router migration.",
"pattern": "getServerSideProps|getStaticProps|next\/router|next\/head|next\/document",
"targetSkill": "nextjs"
}
],
"metadata": {
"docs": [
"https:\/\/nextjs.org\/docs\/app\/guides\/upgrading",
"https:\/\/nextjs.org\/docs\/app\/guides\/upgrading\/codemods"
],
"priority": 6,
"bashPatterns": [
"\\bnpx\\s+@next\/codemod\\b",
"\\bnpm\\s+(install|i|add)\\s+[^\\n]*\\bnext@",
"\\bpnpm\\s+(install|i|add)\\s+[^\\n]*\\bnext@",
"\\bbun\\s+(install|i|add)\\s+[^\\n]*\\bnext@",
"\\byarn\\s+add\\s+[^\\n]*\\bnext@"
],
"pathPatterns": [
"next.config.*",
"package.json"
],
"promptSignals": {
"allOf": [
[
"upgrade",
"next"
],
[
"migrate",
"next"
],
[
"update",
"nextjs"
]
],
"anyOf": [
"breaking changes",
"codemod",
"migration guide",
"version upgrade"
],
"noneOf": [],
"phrases": [
"upgrade next",
"upgrade nextjs",
"migrate next",
"update next.js",
"next.js upgrade",
"nextjs migration",
"next codemod"
],
"minScore": 6
}
},
"retrieval": {
"aliases": [
"next upgrade",
"nextjs migration",
"next codemod"
],
"intents": [
"upgrade Next.js to latest version",
"run Next.js codemods",
"migrate between major Next.js versions"
],
"entities": [
"codemod",
"migration",
"upgrade",
"breaking changes"
]
},
"description": "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."
}
Upgrade Next.js
Upgrade the current project to the latest Next.js version following official migration guides.
Instructions
-
Detect current version: Read
package.jsonto identify the current Next.js version and related dependencies (React, React DOM, etc.) -
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):
-
Determine upgrade path: Based on current version, identify which migration steps apply. For major version jumps, upgrade incrementally (e.g., 13 → 14 → 15).
-
Run codemods first: Next.js provides codemods to automate breaking changes:
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)
-
Update dependencies: Upgrade Next.js and peer dependencies together:
npm install next@latest react@latest react-dom@latest -
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
-
Update TypeScript types (if applicable):
npm install @types/react@latest @types/react-dom@latest -
Test the upgrade:
- Run
npm run buildto check for build errors - Run
npm run devand test key functionality
- Run
Version History
- 08dc189 Current 2026-07-05 19:11
