React/Next.js 开发工作流
概述
专门用于构建 React 和 Next.js 14+ 应用程序的工作流,采用现代模式,包括 App Router、Server Components、TypeScript 和 Tailwind CSS。
何时使用此工作流
在以下情况下使用此工作流:
- 构建新的 React 应用程序
- 创建使用 App Router 的 Next.js 14+ 项目
- 实现 Server Components
- 使用 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 设置 Server Components
阶段 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- Server Componentsreact-state-management- React Queryapi-patterns- API 集成
操作
- 实现 Server Components
- 设置 React Query/SWR
- 创建 API 客户端
- 处理加载状态
- 实现错误边界
可复制的提示
使用 @nextjs-app-router-patterns 实现 Server Components 数据获取
阶段 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 编译无错误
- 所有测试通过
- Linting 检查干净
- 满足性能指标(LCP、CLS、FID)
- 无障碍性检查通过(WCAG 2.1)
- 响应式设计验证通过
相关工作流包
development- 通用开发testing-qa- 测试工作流documentation- 文档typescript-development- TypeScript 模式