SuperAPI AI 工具集

optimize-nextjs-fluidity

前端与建站

查看项目

更新于 10-16 06:45

技能介绍

用途:把未知的 Next.js App Router 仓库变成一次经过测量、排序并执行的优化过程,且只推荐当前安装版本真正支持的能力。适用于性能审计、提升流畅度、修复 Core Web Vitals、Next.js 大版本升级后查找失效配置,以及生成一任务一文件的可审阅计划。不适用于单一已知 bug、通用代码审查、视觉/CSS 问题、非 Next.js 或仅 Pages Router 项目。

主要能力:包含 recon 与能力探测两个门禁原语;按领域做适用性判定;并行审计代理;按依赖顺序生成任务计划;修复波次执行与验证;最终状态核对。覆盖渲染与缓存、图像、字体脚本、打包拆分、导航预取、页面过渡、React 19 微交互、明暗主题、i18n、数据获取、SEO 元数据、构建性能、Vercel 部署、测量与回归护栏等 14 个领域。

使用方式:技能脚本以目标仓库为显式参数。先运行 python3 scripts/recon.py <repo-root> 与 python3 scripts/probe-capabilities.py <repo-root>(均只读),将输出整理进 nextjs-enhancement/00-recon.md;再完成适用性判定并脚手架:python3 scripts/scaffold-plan.py <repo-root> --apply --domains <applicable,domains> --readme references/artifact/artifact-readme.md(默认 dry-run,--apply 仅创建目录与 README)。随后并行审计、合成计划、按波次执行可自动应用任务,最后运行 python3 scripts/status-report.py <repo-root>/nextjs-enhancement 核对。

限制:所有建议必须先做能力探测,不能仅凭版本号比较;不可逆改动(迁移类)只标记为 blocked-needs-human 并附预检清单,绝不自动执行;修复在分支上每任务一次提交,验证失败则回滚;知识基线为 Next.js 16.3.0 / React 19.2(2026-08-05 验证),但不假定目标仓库处于该版本。