Next.js 开发工作流 是做什么的?
选择性阅读规则
从以下文件开始:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
然后仅加载与用户实际任务匹配的继承文档、脚本、资产或示例。
概述
专门用于构建 React 和 Next.js 14+ 应用的工作流,涵盖现代模式,包括 App Router、服务器组件、TypeScript 和 Tailwind CSS。
何时使用此工作流
在以下情况下使用此工作流:
- 构建新的 React 应用
- 使用 App Router 创建 Next.js 14+ 项目
- 实现服务器组件
- 设置 TypeScript 与 React
- 使用 Tailwind CSS 进行样式设计
- 构建全栈 Next.js 应用
工作流阶段
阶段 1:项目搭建
要调用的技能
app-builder- 应用脚手架senior-fullstack- 全栈指导nextjs-app-router-patterns- Next.js 14+ 模式typescript-pro- TypeScript 设置
操作
- 选择项目类型(React SPA、Next.js 应用)
- 选择构建工具(Vite、Next.js、Create React App)
- 搭建项目结构
- 配置 TypeScript
- 设置 ESLint 和 Prettier
可复制粘贴的提示
使用 @app-builder 搭建一个新的 Next.js 14 项目,使用 App Router
使用 @nextjs-app-router-patterns 设置服务器组件
阶段 2:组件架构
要调用的技能
frontend-developer- 组件开发react-patterns- React 模式react-state-management- 状态管理react-ui-patterns- UI 模式
操作
- 设计组件层次结构
- 创建基础组件
- 实现布局组件
- 设置状态管理
- 创建自定义 Hooks
可复制粘贴的提示
使用 @frontend-developer 创建可复用的 React 组件
使用 @react-patterns 实现正确的组件组合
使用 @react-state-management 设置 Zustand store
阶段 3:样式与设计
要调用的技能
frontend-design- UI 设计tailwind-patterns- Tailwind CSStailwind-design-system- 设计系统core-components- 组件库
操作
- 设置 Tailwind CSS
- 配置设计令牌
- 创建实用工具类
- 构建组件样式
- 实现响应式设计
可复制粘贴的提示
使用 @tailwind-patterns 使用 Tailwind CSS v4 为组件添加样式
使用 @frontend-design 创建现代仪表盘 UI
阶段 4:数据获取
要调用的技能
nextjs-app-router-patterns- 服务器组件react-state-management- React Queryapi-patterns- API 集成
操作
- 实现服务器组件
- 设置 React Query/SWR
- 创建 API 客户端
- 处理加载状态
- 实现错误边界
可复制粘贴的提示
使用 @nextjs-app-router-patterns 实现服务器组件的数据获取
阶段 5:路由与导航
要调用的技能
nextjs-app-router-patterns- App Routernextjs-best-practices- Next.js 模式
操作
- 设置基于文件的路由
- 创建动态路由
- 实现嵌套路由
- 添加路由守卫
- 配置重定向
可复制粘贴的提示
使用 @nextjs-app-router-patterns 设置并行路由和拦截路由
阶段 6:表单与验证
要调用的技能
frontend-developer- 表单开发typescript-advanced-types- 类型验证react-ui-patterns- 表单模式
操作
- 选择表单库(React Hook Form、Formik)
- 设置验证(Zod、Yup)
- 创建表单组件
- 处理提交
- 实现错误处理
可复制粘贴的提示
使用 @frontend-developer 创建使用 React Hook Form 和 Zod 的表单
阶段 7:测试
要调用的技能
javascript-testing-patterns- Jest/Vitestplaywright-skill- E2E 测试e2e-testing-patterns- E2E 模式
操作
- 设置测试框架
- 编写单元测试
- 创建组件测试
- 实现 E2E 测试
- 配置 CI 集成
可复制粘贴的提示
使用 @javascript-testing-patterns 编写 Vitest 测试
使用 @playwright-skill 为关键流程创建 E2E 测试
阶段 8:构建与部署
要调用的技能
vercel-deployment- Vercel 部署vercel-deploy-claimable- Vercel 部署web-performance-optimization- 性能
操作
- 配置构建设置
- 优化包体积
- 设置环境变量
- 部署到 Vercel
- 配置预览部署
可复制粘贴的提示
使用 @vercel-deployment 将 Next.js 应用部署到生产环境
技术栈
| 类别 | 技术 |
|---|---|
| 框架 | Next.js 14+, React 18+ |
| 语言 | TypeScript 5+ |
| 样式 | Tailwind CSS v4 |
| 状态管理 | Zustand, React Query |
| 表单 | React Hook Form, Zod |
| 测试 | Vitest, Playwright |
| 部署 | Vercel |
质量门禁
- TypeScript 编译无错误
- 所有测试通过
- 代码检查无问题
- 性能指标达标(LCP、CLS、FID)
- 可访问性检查通过(WCAG 2.1)
- 响应式设计已验证
相关工作流包
development- 通用开发testing-qa- 测试工作流documentation- 文档typescript-development- TypeScript 模式
限制
- 仅在任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少所需的输入、权限、安全边界或成功标准,请停止并请求澄清。