next-upgrade
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.
来源信息
- 仓库
- openai/plugins
- 最近来源活动
- 2026年8月26日 20:49
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 7,310
- 分支
- 949
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
文件资源管理器
2 个文件正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- next-upgrade
- 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.
- metadata
- {"priority":6,"docs":["https://nextjs.org/docs/app/guides/upgrading","https://nextjs.org/docs/app/guides/upgrading/codemods"],"pathPatterns":["next.config.*","package.json"],"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@"],"promptSignals":{"phrases":["upgrade next","upgrade nextjs","migrate next","update next.js","next.js upgrade","nextjs migration","next codemod"],"allOf":["[Truncated]","[Truncated]","[Truncated]"],"anyOf":["breaking changes","codemod","migration guide","version upgrade"],"noneOf":[],"minScore":6}}
# 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.)
2. **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
3. **Determine upgrade path**: Based on current version, identify which migration steps apply. For major version jumps, upgrade incrementally (e.g., 13 → 14 → 15).
4. **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)
5. **Update dependencies**: Upgrade Next.js and peer dependencies together:
```bash
npm install next@latest react@latest react-dom@latest
```
6. **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
7. **Update TypeScript types** (if applicable):
```bash
npm install @types/react@latest @types/react-dom@latest
```
8. **Test the upgrade**:
- Run `npm run build` to check for build errors
- Run `npm run dev` and test key functionality
在 GitHub 查看