React/Next.js 開發工作流程
概述
專為使用現代模式(包括 App Router、Server Components、TypeScript 與 Tailwind CSS)建置 React 與 Next.js 14+ 應用程式而設計的專門工作流程。
何時使用此工作流程
在以下情況使用此工作流程:
- 建置新的 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 來 scaffold 一個新的 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 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 模式
限制
- 僅在任務明確符合上述範圍時使用此技能。
- 請勿將輸出視為環境特定驗證、測試或專家審查的替代方案。
- 如果缺少必要的輸入、權限、安全邊界或成功標準,請停止並請求釐清。