用途
nextjs-developer 是一项面向 Next.js 14+ 的应用开发技能,定位为资深 Next.js 开发者,聚焦 App Router、服务端组件与全栈部署,强调性能与 SEO 优秀。
主要能力与工作流
技能将开发过程分为五个阶段:
- 架构规划:定义应用结构、路由、布局与渲染策略。
- 实现路由:创建 App Router 结构,包含布局、模板、loading 与 error 状态。
- 数据层:设置服务端组件、数据获取、缓存与重验证。
- 优化:图片、字体、打包体积、流式渲染与边缘运行时。
- 部署:生产构建、环境设置与监控。部署前需验证:本地运行
next build、确认零类型错误、检查NEXT_PUBLIC_*与服务端专用环境变量是否已设置、运行 Lighthouse/PageSpeed 确认 Core Web Vitals 大于 90。
使用方式
技能附带分主题的参考文档,可根据上下文加载:
| 主题 | 参考文档 | 加载时机 |
|---|---|---|
| App Router | references/app-router.md |
基于文件的路由、布局、模板、路由组 |
| 服务端组件 | references/server-components.md |
RSC 模式、流式渲染、客户端边界 |
| 服务端操作 | references/server-actions.md |
表单处理、数据变更、重验证 |
| 数据获取 | references/data-fetching.md |
fetch、缓存、ISR、按需重验证 |
| 部署 | references/deployment.md |
Vercel、自托管、Docker、优化 |
实现 Next.js 功能时,技能建议提供以下输出:应用结构(路由组织)、带正确数据获取的布局/页面组件、如需要数据变更则提供服务端操作、配置(next.config.js、TypeScript),以及对所选渲染策略的简要说明。
约束规则
必须做(Next.js 专属):
- 使用 App Router(
app/目录),绝不使用 Pages Router(pages/)。 - 组件默认保持为服务端组件;仅在需要交互的叶子边界添加
'use client'。 - 使用原生
fetch并显式指定cache/next.revalidate选项,不依赖隐式缓存。 - 所有 SEO 使用
generateMetadata(或静态metadata导出),绝不在 JSX 中硬编码<title>或<meta>标签。 - 所有图片用
next/image优化;内容图片绝不使用普通<img>标签。 - 在每个执行异步数据获取的路由段添加
loading.tsx和error.tsx。
绝不要做:
- 仅为访问数据而把组件转成客户端组件,应先服务端获取。
- 在异步路由段跳过
loading.tsx/error.tsx边界。 - 未运行
next build确认零错误就部署。
代码示例
带数据获取与缓存的服务端组件
// app/products/page.tsx
import { Suspense } from 'react'
async function ProductList() {
// Revalidate every 60 seconds (ISR)
const res = await fetch('https://api.example.com/products', {
next: { revalidate: 60 },
})
if (!res.ok) throw new Error('Failed to fetch products')
const products: Product[] = await res.json()
return (
<ul>
{products.map((p) => (
<li key={p.id}>{p.name}</li>
))}
</ul>
)
}
export default function Page() {
return (
<Suspense fallback={<p>Loading…</p>}>
<ProductList />
</Suspense>
)
}
带表单处理与重验证的服务端操作
// app/products/actions.ts
'use server'
import { revalidatePath } from 'next/cache'
export async function createProduct(formData: FormData) {
const name = formData.get('name') as string
await db.product.create({ data: { name } })
revalidatePath('/products')
}
// app/products/new/page.tsx
import { createProduct } from '../actions'
export default function NewProductPage() {
return (
<form action={createProduct}>
<input name="name" placeholder="Product name" required />
<button type="submit">Create</button>
</form>
)
}
用于动态 SEO 的 generateMetadata
// app/products/[id]/page.tsx
import type { Metadata } from 'next'
export async function generateMetadata(
{ params }: { params: { id: string } }
): Promise<Metadata> {
const product = await fetchProduct(params.id)
return {
title: product.name,
description: product.description,
openGraph: { title: product.name, images: [product.imageUrl] },
}
}
知识范围
Next.js 14+、App Router、React 服务端组件、服务端操作、流式 SSR、部分预渲染、next/image、next/font、Metadata API、路由处理器(Route Handlers)、中间件(Middleware)、边缘运行时、Turbopack、Vercel 部署。
适用场景
适合构建使用 App Router 的 Next.js 14+ 全栈应用,包括需要服务端渲染、流式渲染、SEO 优化与 Vercel 部署的项目。
限制
资料未提供具体的安装命令、收费与价格信息,也未说明支持的平台细节;相关内容暂未提供。技能本身包含的约束(如必须使用 App Router、默认服务端组件等)属于使用规范,而非平台限制。
引用文档
以下为作者声明的引用来源,保留指定版本、署名和许可。
- jeffallan/claude-skills/skills/nextjs-developer/SKILL.md — 署名:Jeffallan;许可:MIT;版本:
3bf9a24b76a7c122f1fc05e83929fbc84e1c207a。