SuperAPI AI 工具集

nextjs-upgrade

前端与建站

查看项目

更新于 10-15 17:23

技能介绍

用途:评估并升级 Next.js 项目。先从当前 Next.js 发布与升级指南解析目标版本,再与项目实际安装状态对比,给出迁移路径。内置升级路径脚本针对 Next.js 15 到 16 做过测试;其他目标版本可用其检测与测量脚本,但迁移步骤应来自对应的官方指南,不要把 v16 方案当作通用方案。

主要能力:脚本负责机械性检测与测量,包括扫描 package.json、检查锁文件、解析构建输出。detect-nextjs.sh 返回项目状态 JSON,含 Next.js/React/TypeScript 版本、包管理器、Node 版本、路由类型(App/Pages)、linter、formatter、CSS 框架、配置文件、Turbopack 标志、React Compiler、middleware/proxy 文件及 scripts。check-upgrade-path.sh 输出有序升级计划,含复杂度、步骤、codemod 与破坏性变更。measure-build.sh 在升级前后测量构建耗时、警告、错误与包体积。

使用方式:先运行检测:bash <skill-path>/scripts/detect-nextjs.sh /path/to/project;再检查升级路径:bash <skill-path>/scripts/detect-nextjs.sh /path/to/project | bash <skill-path>/scripts/check-upgrade-path.sh;可选测量构建:bash <skill-path>/scripts/measure-build.sh /path/to/project。按优先级顺序执行步骤数组。典型流程为检测、测量基线、获取步骤、执行安装依赖与 codemod、手动改配置、再次测量并报告改进。

适用场景:Next.js 项目跨版本升级,尤其是 15 到 16;需要量化构建性能前后差异;需要识别路由、linter、Turbopack、middleware 等迁移点。

限制:脚本仅对 15 到 16 路径经过测试,其他目标需依赖对应官方指南;检测结果依赖项目实际文件,未提供的信息不会推断;具体收费、平台与效果资料暂未提供。