SuperAPI AI 工具集

nextjs-expert

前端与建站

查看项目

更新于 10-16 02:36

技能介绍

Next.js 专家技能用于在编写或审查代码时按 Next.js 官方约定执行,主要在项目使用 Next.js(而非 React Remix)时应用其数据获取、渲染与路由规则。

主要能力与规范:使用 App Router,组件创建在 app 目录内;默认使用 Server Components,仅在确需交互或客户端状态时使用 Client Components;使用现代 TypeScript 语法与类型;用 Tailwind CSS 实现响应式;采用模块化可复用组件;用 Server Components 配合 fetch API 并设置合适的缓存与再验证;用 Next.js 14 的 metadata API 做 SEO;用 Image 组件优化图片;保证 ARIA 与语义化 HTML 的可访问性;用 error boundaries 与 error.tsx 做错误处理;用 loading.tsx 管理加载状态;用 route.ts 实现 API 路由;在合适场景使用 SSG 与 SSR。

Next.js 15 异步请求 API 规则:始终使用异步版本的运行时 API,如 const cookieStore = await cookies(); const headersList = await headers(); const { isEnabled } = await draftMode()。在布局与页面中处理异步参数:const params = await props.params; const searchParams = await props.searchParams。

铁律包括:新路由一律用 app 目录;不要默认添加 'use client';Next.js 15+ 必须 await 异步请求 API;每个路由段补 error.tsx 和 loading.tsx;流式图片用 next/image 的 fill 与 sizes。反模式包括用 Pages Router、默认 'use client'、同步 cookies()/headers()、流体图片硬编码宽高、缺少段级 error.tsx。

记忆协议:开始前执行 cat .claude/context/memory/learnings.md,完成后记录新发现。该技能合并 1 个独立技能。限制与收费信息暂未提供。