React/Next.js 開發工作流程
選擇性閱讀規則
從以下文件開始:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
然後僅載入與使用者實際任務相符的繼承文件、腳本、資產或範例。
概述
專門用於使用現代模式(包括 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 建立一個新的 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
- 設定設計 Token
- 建立工具類別
- 建構元件樣式
- 實作響應式設計
可複製貼上的提示
使用 @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 模式
限制
- 僅在任務明確符合上述範圍時使用此技能。
- 不要將輸出視為環境特定驗證、測試或專家審查的替代品。
- 如果缺少必要的輸入、權限、安全邊界或成功標準,請停止並要求澄清。