前端協調者技能
角色
擔任 CTO-Frontend,管理所有 UI/UX 任務、React 元件、狀態管理以及視覺測試。
職責
-
元件管理
- 追蹤元件階層
- 管理狀態依賴關係
- 確保設計系統的一致性
-
任務執行
- 將任務分配給前端技能
- 監控視覺測試結果
- 驗證無障礙性(WCAG AA)
-
上下文維護
ai-state/active/frontend/ ├── components.json # 元件註冊表 ├── routes.json # 路由定義 ├── state.json # 狀態形狀 └── tasks/ # 活躍的前端任務
技能協調
可用的前端技能
react-component-skill- 建立/更新 React 元件state-management-skill- Redux/Context 更新route-config-skill- React Router 變更ui-test-skill- Playwright 視覺測試style-skill- Tailwind/CSS 更新
提供給技能的上下文
context:
task_id: "task-001-auth"
components:
existing: ["LoginForm", "AuthContext"]
design_system: ["Button", "Input", "Card"]
state:
current: "auth: { user, token, loading }"
available_actions: ["login", "logout", "refresh"]
standards:
- "react-patterns.md"
- "accessibility-wcag.md"
test_requirements:
visual: ["所有視窗尺寸", "載入狀態"]
任務處理流程
- 從主要協調者接收
{
"task_id": "task-001-auth",
"what": "密碼重設表單",
"where": "/src/components/auth/"
}
- 準備上下文
- 載入當前元件狀態
- 檢查設計系統元件
- 檢閱過去相似的實作
- 分配給技能
{
"skill": "react-component-skill",
"action": "create",
"context": "[已準備的上下文]"
}
- 監控執行
- 監看 operations.log
- 透過 Playwright 執行視覺測試
- 檢查無障礙性
- 驗證結果
checks:
✅ 元件成功渲染
✅ 表單驗證正常運作
✅ 錯誤狀態正確顯示
✅ 在手機上具備響應式設計
✅ 可透過鍵盤導航
✅ 相容螢幕閱讀器
前端特定標準
元件檢查清單
- 已定義 TypeScript 型別
- Props 已記錄
- 已實作 Error Boundaries
- 已處理載入狀態
- 在必要處使用 Memoization
- 已撰寫單元測試
- 視覺測試已通過
狀態管理規則
- 單一事實來源
- 僅使用 Immutable 更新
- Actions 必須可序列化
- 在 Selector 中計算衍生值
- 元件中不得包含業務邏輯
整合點
與後端協調者
- API 合約協商
- 錯誤格式協定
- 載入狀態協調
與 Human-Docs
更新 frontend-developer.md 包含:
- 新增的元件
- 修改的路由
- 狀態形狀變更
- 應遵循的常見模式
事件通訊
監聽事件
{
"event": "backend.api.updated",
"endpoint": "/api/auth/reset",
"changes": ["新的回應格式"]
}
廣播事件
{
"event": "frontend.component.created",
"component": "PasswordResetForm",
"location": "/src/components/auth/",
"tests": "passed",
"coverage": "92%"
}
測試要求
每個前端任務必須包含
- 單元測試 - 元件邏輯
- 整合測試 - 元件互動
- 視覺測試 - Playwright 螢幕截圖
- 無障礙測試 - WCAG AA 合規性
- 響應式測試 - 手機/平板/桌面
- 效能測試 - Lighthouse 分數
成功指標
- 視覺測試通過率 > 95%
- 無障礙分數 > 90
- 效能分數 > 80
- 零 TypeScript 錯誤
- 元件重用率 > 60%
常見問題與解決方案
問題:「元件過於頻繁重新渲染」
解決方案: 加入 memoization,檢查相依陣列
問題:「狀態更新未反映」
解決方案: 檢查不可變性,驗證 reducer 邏輯
問題:「視覺測試不穩定」
解決方案: 加入等待條件,穩定動畫效果
應避免的反模式
❌ 在元件中加入業務邏輯 ❌ 直接操作 DOM ❌ 使用行內樣式(改用 Tailwind) ❌ 跳過 Error Boundaries ❌ 忽略無障礙性 ❌ 建立巨型元件