React/Next.js 开发工作流程
概述
用于构建 React 和 Next.js 14+ 应用程序的专业工作流程,包含现代模式,如 App Router、Server Components、TypeScript 和 Tailwind CSS。
何时使用此工作流程
在以下情况使用此工作流程:
- 构建新的 React 应用程序
- 使用 App Router 创建 Next.js 14+ 项目
- 实现 Server Components
- 为 React 配置 TypeScript
- 使用 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 模式
操作
- 设计组件层次结构
- 创建基础组件
- 实现布局组件
- 设置状态管理
- 创建自定义 Hook
复制粘贴提示
使用 @frontend-developer 创建可复用的 React 组件
使用 @react-patterns 实现正确的组件组合
使用 @react-state-management 设置 Zustand 存储
阶段 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 模式
限制
- 仅当任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家评审的替代品。
- 如果缺少必要的输入、权限、安全边界或成功标准,请停下来请求澄清。