AI Skill 大全

Next.js 开发规范

给出 Next.js App Router 的代码或架构问题,产出符合官方最佳实践的写法与对应的检查要点。

功能与用途

写或评审 Next.js 代码时,最容易出错的地方是服务端与客户端组件的边界、数据获取方式和缓存策略。这个能力把官方最佳实践拆成路由约定、RSC 边界、异步 API、运行时选择、指令、路由处理器、元数据、图片与字体优化、打包、水合错误、Suspense 边界、并行与拦截路由、自托管等主题,逐项给出参考文档与改法,还包含用 MCP 端点和 --debug-build-paths 做调试的技巧。

适用场景

  • App Router 架构与边界规范:检查服务端与客户端组件边界,规避非序列化 props 与非法异步客户端组件错误。
  • 性能与资源加载优化:按规范配置 next/image、next/font 以及静态元数据,优化核心 Web 性能指标。
  • 水合错误与路由异常排查:定位浏览器 API 错用引起的水合失败,并规范 Suspense 边界与并行拦截路由写法。

适用人群

  • 用 App Router 写 Next.js 的前端开发
  • 做 Next.js 代码评审的技术负责人
  • 要从 Pages Router 迁到 App Router 的工程师

使用步骤

  1. 把 Next.js 相关文件或报错现象发过去,说明是路由、数据获取、缓存还是渲染问题
  2. 让它按主题定位到对应规则,比如 RSC 边界、异步 params、指令或缓存句柄
  3. 拿到具体的改法:文件该放哪、加什么指令、哪些函数要 await、需要包哪层 Suspense
  4. 按建议改完跑 next build 与 next dev,确认构建错误和水合警告消失

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
Codex、Claude Code、OpenClaw、Hermes、国内 Agent
使用难度
进阶
版本
main
最近更新
2026-09-18
文件数
3
安装包大小
自动生成 ZIP
安全检查
基础检查通过

Next.js App Router expert guidance. Use when building, debugging, or architecting Next.js applications — routing, Server Components, Server Actions, Cache Components, layouts, middleware/proxy, data fetching, rendering strategies, and deployment on Vercel.

使用前准备

  • 有一个 Next.js 项目(App Router 或 Pages Router),能本地跑 next dev/build

依赖与权限

  • 读取用户主动提供的内容

同类 Skill