[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7AMAS0H6G2H1X12TZYKPP32":3,"skill-same:01M7AMAS0H6G2H1X12TZYKPP32":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M7AMAS0H6G2H1X12TZYKPP32","frontend-patterns",null,"Frontend development patterns for React, Next.js, state management, performance optimization, and UI best practices.","Cyrilthetecchieee\u002Fcyril-code-","Cyrilthetecchieee","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219787998?v=4","01M7AF0MMMKRAA0H61XMJPV92H","Julian Cyril D ","01M7AF0MQ10AVG6QJQ1C2BC0F5",2,"MIT","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fzh-TW\u002Fskills\u002Ffrontend-patterns\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: frontend-patterns\ndescription: Frontend development patterns for React, Next.js, state management, performance optimization, and UI best practices.\n---\n\n# 前端開發模式\n\n用於 React、Next.js 和高效能使用者介面的現代前端模式。\n\n## 元件模式\n\n### 組合優於繼承\n\n```typescript\n\u002F\u002F PASS: 良好：元件組合\ninterface CardProps {\n  children: React.ReactNode\n  variant?: 'default' | 'outlined'\n}\n\nexport function Card({ children, variant = 'default' }: CardProps) {\n  return \u003Cdiv className={`card card-${variant}`}>{children}\u003C\u002Fdiv>\n}\n\nexport function CardHeader({ children }: { children: React.ReactNode }) {\n  return \u003Cdiv className=\"card-header\">{children}\u003C\u002Fdiv>\n}\n\nexport function CardBody({ children }: { children: React.ReactNode }) {\n  return \u003Cdiv className=\"card-body\">{children}\u003C\u002Fdiv>\n}\n\n\u002F\u002F 使用方式\n\u003CCard>\n  \u003CCardHeader>標題\u003C\u002FCardHeader>\n  \u003CCardBody>內容\u003C\u002FCardBody>\n\u003C\u002FCard>\n```\n\n### 複合元件\n\n```typescript\ninterface TabsContextValue {\n  activeTab: string\n  setActiveTab: (tab: string) => void\n}\n\nconst TabsContext = createContext\u003CTabsContextValue | undefined>(undefined)\n\nexport function Tabs({ children, defaultTab }: {\n  children: React.ReactNode\n  defaultTab: string\n}) {\n  const [activeTab, setActiveTab] = useState(defaultTab)\n\n  return (\n    \u003CTabsContext.Provider value={{ activeTab, setActiveTab }}>\n      {children}\n    \u003C\u002FTabsContext.Provider>\n  )\n}\n\nexport function TabList({ children }: { children: React.ReactNode }) {\n  return \u003Cdiv className=\"tab-list\">{children}\u003C\u002Fdiv>\n}\n\nexport function Tab({ id, children }: { id: string, children: React.ReactNode }) {\n  const context = useContext(TabsContext)\n  if (!context) throw new Error('Tab must be used within Tabs')\n\n  return (\n    \u003Cbutton\n      className={context.activeTab === id ? 'active' : ''}\n      onClick={() => context.setActiveTab(id)}\n    >\n      {children}\n    \u003C\u002Fbutton>\n  )\n}\n\n\u002F\u002F 使用方式\n\u003CTabs defaultTab=\"overview\">\n  \u003CTabList>\n    \u003CTab id=\"overview\">概覽\u003C\u002FTab>\n    \u003CTab id=\"details\">詳情\u003C\u002FTab>\n  \u003C\u002FTabList>\n\u003C\u002FTabs>\n```\n\n### Render Props 模式\n\n```typescript\ninterface DataLoaderProps\u003CT> {\n  url: string\n  children: (data: T | null, loading: boolean, error: Error | null) => React.ReactNode\n}\n\nexport function DataLoader\u003CT>({ url, children }: DataLoaderProps\u003CT>) {\n  const [data, setData] = useState\u003CT | null>(null)\n  const [loading, setLoading] = useState(true)\n  const [error, setError] = useState\u003CError | null>(null)\n\n  useEffect(() => {\n    fetch(url)\n      .then(res => res.json())\n      .then(setData)\n      .catch(setError)\n      .finally(() => setLoading(false))\n  }, [url])\n\n  return \u003C>{children(data, loading, error)}\u003C\u002F>\n}\n\n\u002F\u002F 使用方式\n\u003CDataLoader\u003CMarket[]> url=\"\u002Fapi\u002Fmarkets\">\n  {(markets, loading, error) => {\n    if (loading) return \u003CSpinner \u002F>\n    if (error) return \u003CError error={error} \u002F>\n    return \u003CMarketList markets={markets!} \u002F>\n  }}\n\u003C\u002FDataLoader>\n```\n\n## 自訂 Hooks 模式\n\n### 狀態管理 Hook\n\n```typescript\nexport function useToggle(initialValue = false): [boolean, () => void] {\n  const [value, setValue] = useState(initialValue)\n\n  const toggle = useCallback(() => {\n    setValue(v => !v)\n  }, [])\n\n  return [value, toggle]\n}\n\n\u002F\u002F 使用方式\nconst [isOpen, toggleOpen] = useToggle()\n```\n\n### 非同步資料取得 Hook\n\n```typescript\ninterface UseQueryOptions\u003CT> {\n  onSuccess?: (data: T) => void\n  onError?: (error: Error) => void\n  enabled?: boolean\n}\n\nexport function useQuery\u003CT>(\n  key: string,\n  fetcher: () => Promise\u003CT>,\n  options?: UseQueryOptions\u003CT>\n) {\n  const [data, setData] = useState\u003CT | null>(null)\n  const [error, setError] = useState\u003CError | null>(null)\n  const [loading, setLoading] = useState(false)\n\n  \u002F\u002F 將最新的 fetcher\u002Foptions 保存在 ref 中，讓 refetch 即使在呼叫端\n  \u002F\u002F 傳入行內函式與物件字面值時也能保持參照穩定。\n  \u002F\u002F 若沒有這麼做，每次渲染都會建立新的 refetch，下方的 effect 會在\n  \u002F\u002F 每次狀態更新後重新執行，造成無限取得迴圈。\n  const fetcherRef = useRef(fetcher)\n  const optionsRef = useRef(options)\n  useEffect(() => {\n    fetcherRef.current = fetcher\n    optionsRef.current = options\n  })\n\n  const refetch = useCallback(async () => {\n    setLoading(true)\n    setError(null)\n\n    try {\n      const result = await fetcherRef.current()\n      setData(result)\n      optionsRef.current?.onSuccess?.(result)\n    } catch (err) {\n      const error = err as Error\n      setError(error)\n      optionsRef.current?.onError?.(error)\n    } finally {\n      setLoading(false)\n    }\n  }, [])\n\n  const enabled = options?.enabled !== false\n\n  useEffect(() => {\n    if (enabled) {\n      refetch()\n    }\n  }, [key, enabled, refetch])\n\n  return { data, error, loading, refetch }\n}\n\n\u002F\u002F 使用方式\nconst { data: markets, loading, error, refetch } = useQuery(\n  'markets',\n  () => fetch('\u002Fapi\u002Fmarkets').then(r => r.json()),\n  {\n    onSuccess: data => console.log('Fetched', data.length, 'markets'),\n    onError: err => console.error('Failed:', err)\n  }\n)\n```\n\n### Debounce Hook\n\n```typescript\nexport function useDebounce\u003CT>(value: T, delay: number): T {\n  const [debouncedValue, setDebouncedValue] = useState\u003CT>(value)\n\n  useEffect(() => {\n    const handler = setTimeout(() => {\n      setDebouncedValue(value)\n    }, delay)\n\n    return () => clearTimeout(handler)\n  }, [value, delay])\n\n  return debouncedValue\n}\n\n\u002F\u002F 使用方式\nconst [searchQuery, setSearchQuery] = useState('')\nconst debouncedQuery = useDebounce(searchQuery, 500)\n\nuseEffect(() => {\n  if (debouncedQuery) {\n    performSearch(debouncedQuery)\n  }\n}, [debouncedQuery])\n```\n\n## 狀態管理模式\n\n### Context + Reducer 模式\n\n```typescript\ninterface State {\n  markets: Market[]\n  selectedMarket: Market | null\n  loading: boolean\n}\n\ntype Action =\n  | { type: 'SET_MARKETS'; payload: Market[] }\n  | { type: 'SELECT_MARKET'; payload: Market }\n  | { type: 'SET_LOADING'; payload: boolean }\n\nfunction reducer(state: State, action: Action): State {\n  switch (action.type) {\n    case 'SET_MARKETS':\n      return { ...state, markets: action.payload }\n    case 'SELECT_MARKET':\n      return { ...state, selectedMarket: action.payload }\n    case 'SET_LOADING':\n      return { ...state, loading: action.payload }\n    default:\n      return state\n  }\n}\n\nconst MarketContext = createContext\u003C{\n  state: State\n  dispatch: Dispatch\u003CAction>\n} | undefined>(undefined)\n\nexport function MarketProvider({ children }: { children: React.ReactNode }) {\n  const [state, dispatch] = useReducer(reducer, {\n    markets: [],\n    selectedMarket: null,\n    loading: false\n  })\n\n  return (\n    \u003CMarketContext.Provider value={{ state, dispatch }}>\n      {children}\n    \u003C\u002FMarketContext.Provider>\n  )\n}\n\nexport function useMarkets() {\n  const context = useContext(MarketContext)\n  if (!context) throw new Error('useMarkets must be used within MarketProvider')\n  return context\n}\n```\n\n## 效能優化\n\n### 記憶化\n\n```typescript\n\u002F\u002F PASS: useMemo 用於昂貴計算\n\u002F\u002F 排序前先複製 - Array.prototype.sort 會就地修改陣列\nconst sortedMarkets = useMemo(() => {\n  return [...markets].sort((a, b) => b.volume - a.volume)\n}, [markets])\n\n\u002F\u002F PASS: useCallback 用於傳遞給子元件的函式\nconst handleSearch = useCallback((query: string) => {\n  setSearchQuery(query)\n}, [])\n\n\u002F\u002F PASS: React.memo 用於純元件\nexport const MarketCard = React.memo\u003CMarketCardProps>(({ market }) => {\n  return (\n    \u003Cdiv className=\"market-card\">\n      \u003Ch3>{market.name}\u003C\u002Fh3>\n      \u003Cp>{market.description}\u003C\u002Fp>\n    \u003C\u002Fdiv>\n  )\n})\n```\n\n### 程式碼分割與延遲載入\n\n```typescript\nimport { lazy, Suspense } from 'react'\n\n\u002F\u002F PASS: 延遲載入重型元件\nconst HeavyChart = lazy(() => import('.\u002FHeavyChart'))\nconst ThreeJsBackground = lazy(() => import('.\u002FThreeJsBackground'))\n\nexport function Dashboard() {\n  return (\n    \u003Cdiv>\n      \u003CSuspense fallback={\u003CChartSkeleton \u002F>}>\n        \u003CHeavyChart data={data} \u002F>\n      \u003C\u002FSuspense>\n\n      \u003CSuspense fallback={null}>\n        \u003CThreeJsBackground \u002F>\n      \u003C\u002FSuspense>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n### 長列表虛擬化\n\n```typescript\nimport { useVirtualizer } from '@tanstack\u002Freact-virtual'\n\nexport function VirtualMarketList({ markets }: { markets: Market[] }) {\n  const parentRef = useRef\u003CHTMLDivElement>(null)\n\n  const virtualizer = useVirtualizer({\n    count: markets.length,\n    getScrollElement: () => parentRef.current,\n    estimateSize: () => 100,  \u002F\u002F 預估行高\n    overscan: 5  \u002F\u002F 額外渲染的項目數\n  })\n\n  return (\n    \u003Cdiv ref={parentRef} style={{ height: '600px', overflow: 'auto' }}>\n      \u003Cdiv\n        style={{\n          height: `${virtualizer.getTotalSize()}px`,\n          position: 'relative'\n        }}\n      >\n        {virtualizer.getVirtualItems().map(virtualRow => (\n          \u003Cdiv\n            key={virtualRow.index}\n            style={{\n              position: 'absolute',\n              top: 0,\n              left: 0,\n              width: '100%',\n              height: `${virtualRow.size}px`,\n              transform: `translateY(${virtualRow.start}px)`\n            }}\n          >\n            \u003CMarketCard market={markets[virtualRow.index]} \u002F>\n          \u003C\u002Fdiv>\n        ))}\n      \u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n## 表單處理模式\n\n### 帶驗證的受控表單\n\n```typescript\ninterface FormData {\n  name: string\n  description: string\n  endDate: string\n}\n\ninterface FormErrors {\n  name?: string\n  description?: string\n  endDate?: string\n}\n\nexport function CreateMarketForm() {\n  const [formData, setFormData] = useState\u003CFormData>({\n    name: '',\n    description: '',\n    endDate: ''\n  })\n\n  const [errors, setErrors] = useState\u003CFormErrors>({})\n\n  const validate = (): boolean => {\n    const newErrors: FormErrors = {}\n\n    if (!formData.name.trim()) {\n      newErrors.name = '名稱為必填'\n    } else if (formData.name.length > 200) {\n      newErrors.name = '名稱必須少於 200 個字元'\n    }\n\n    if (!formData.description.trim()) {\n      newErrors.description = '描述為必填'\n    }\n\n    if (!formData.endDate) {\n      newErrors.endDate = '結束日期為必填'\n    }\n\n    setErrors(newErrors)\n    return Object.keys(newErrors).length === 0\n  }\n\n  const handleSubmit = async (e: React.FormEvent) => {\n    e.preventDefault()\n\n    if (!validate()) return\n\n    try {\n      await createMarket(formData)\n      \u002F\u002F 成功處理\n    } catch (error) {\n      \u002F\u002F 錯誤處理\n    }\n  }\n\n  return (\n    \u003Cform onSubmit={handleSubmit}>\n      \u003Cinput\n        value={formData.name}\n        onChange={e => setFormData(prev => ({ ...prev, name: e.target.value }))}\n        placeholder=\"市場名稱\"\n      \u002F>\n      {errors.name && \u003Cspan className=\"error\">{errors.name}\u003C\u002Fspan>}\n\n      {\u002F* 其他欄位 *\u002F}\n\n      \u003Cbutton type=\"submit\">建立市場\u003C\u002Fbutton>\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Error Boundary 模式\n\n```typescript\ninterface ErrorBoundaryState {\n  hasError: boolean\n  error: Error | null\n}\n\nexport class ErrorBoundary extends React.Component\u003C\n  { children: React.ReactNode },\n  ErrorBoundaryState\n> {\n  state: ErrorBoundaryState = {\n    hasError: false,\n    error: null\n  }\n\n  static getDerivedStateFromError(error: Error): ErrorBoundaryState {\n    return { hasError: true, error }\n  }\n\n  componentDidCatch(error: Error, errorInfo: React.ErrorInfo) {\n    console.error('Error boundary caught:', error, errorInfo)\n  }\n\n  render() {\n    if (this.state.hasError) {\n      return (\n        \u003Cdiv className=\"error-fallback\">\n          \u003Ch2>發生錯誤\u003C\u002Fh2>\n          \u003Cp>{this.state.error?.message}\u003C\u002Fp>\n          \u003Cbutton onClick={() => this.setState({ hasError: false })}>\n            重試\n          \u003C\u002Fbutton>\n        \u003C\u002Fdiv>\n      )\n    }\n\n    return this.props.children\n  }\n}\n\n\u002F\u002F 使用方式\n\u003CErrorBoundary>\n  \u003CApp \u002F>\n\u003C\u002FErrorBoundary>\n```\n\n## 動畫模式\n\n### Framer Motion 動畫\n\n```typescript\nimport { motion, AnimatePresence } from 'framer-motion'\n\n\u002F\u002F PASS: 列表動畫\nexport function AnimatedMarketList({ markets }: { markets: Market[] }) {\n  return (\n    \u003CAnimatePresence>\n      {markets.map(market => (\n        \u003Cmotion.div\n          key={market.id}\n          initial={{ opacity: 0, y: 20 }}\n          animate={{ opacity: 1, y: 0 }}\n          exit={{ opacity: 0, y: -20 }}\n          transition={{ duration: 0.3 }}\n        >\n          \u003CMarketCard market={market} \u002F>\n        \u003C\u002Fmotion.div>\n      ))}\n    \u003C\u002FAnimatePresence>\n  )\n}\n\n\u002F\u002F PASS: Modal 動畫\nexport function Modal({ isOpen, onClose, children }: ModalProps) {\n  return (\n    \u003CAnimatePresence>\n      {isOpen && (\n        \u003C>\n          \u003Cmotion.div\n            className=\"modal-overlay\"\n            initial={{ opacity: 0 }}\n            animate={{ opacity: 1 }}\n            exit={{ opacity: 0 }}\n            onClick={onClose}\n          \u002F>\n          \u003Cmotion.div\n            className=\"modal-content\"\n            initial={{ opacity: 0, scale: 0.9, y: 20 }}\n            animate={{ opacity: 1, scale: 1, y: 0 }}\n            exit={{ opacity: 0, scale: 0.9, y: 20 }}\n          >\n            {children}\n          \u003C\u002Fmotion.div>\n        \u003C\u002F>\n      )}\n    \u003C\u002FAnimatePresence>\n  )\n}\n```\n\n## 無障礙模式\n\n### 鍵盤導航\n\n```typescript\nexport function Dropdown({ options, onSelect }: DropdownProps) {\n  const [isOpen, setIsOpen] = useState(false)\n  const [activeIndex, setActiveIndex] = useState(0)\n\n  const handleKeyDown = (e: React.KeyboardEvent) => {\n    switch (e.key) {\n      case 'ArrowDown':\n        e.preventDefault()\n        setActiveIndex(i => Math.min(i + 1, options.length - 1))\n        break\n      case 'ArrowUp':\n        e.preventDefault()\n        setActiveIndex(i => Math.max(i - 1, 0))\n        break\n      case 'Enter':\n        e.preventDefault()\n        onSelect(options[activeIndex])\n        setIsOpen(false)\n        break\n      case 'Escape':\n        setIsOpen(false)\n        break\n    }\n  }\n\n  return (\n    \u003Cdiv\n      role=\"combobox\"\n      aria-expanded={isOpen}\n      aria-haspopup=\"listbox\"\n      onKeyDown={handleKeyDown}\n    >\n      {\u002F* 下拉選單實作 *\u002F}\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n### 焦點管理\n\n```typescript\nexport function Modal({ isOpen, onClose, children }: ModalProps) {\n  const modalRef = useRef\u003CHTMLDivElement>(null)\n  const previousFocusRef = useRef\u003CHTMLElement | null>(null)\n\n  useEffect(() => {\n    if (isOpen) {\n      \u002F\u002F 儲存目前聚焦的元素\n      previousFocusRef.current = document.activeElement as HTMLElement\n\n      \u002F\u002F 聚焦 modal\n      modalRef.current?.focus()\n    } else {\n      \u002F\u002F 關閉時恢復焦點\n      previousFocusRef.current?.focus()\n    }\n  }, [isOpen])\n\n  return isOpen ? (\n    \u003Cdiv\n      ref={modalRef}\n      role=\"dialog\"\n      aria-modal=\"true\"\n      tabIndex={-1}\n      onKeyDown={e => e.key === 'Escape' && onClose()}\n    >\n      {children}\n    \u003C\u002Fdiv>\n  ) : null\n}\n```\n\n**記住**：現代前端模式能實現可維護、高效能的使用者介面。選擇符合你專案複雜度的模式。\n","# 前端開發模式\n\n用於 React、Next.js 和高效能使用者介面的現代前端模式。\n\n## 元件模式\n\n### 組合優於繼承\n\n```typescript\n\u002F\u002F PASS: 良好：元件組合\ninterface CardProps {\n  children: React.ReactNode\n  variant?: 'default' | 'outlined'\n}\n\nexport function Card({ children, variant = 'default' }: CardProps) {\n  return \u003Cdiv className={`card card-${variant}`}>{children}\u003C\u002Fdiv>\n}\n\nexport function CardHeader({ children }: { children: React.ReactNode }) {\n  return \u003Cdiv className=\"card-header\">{children}\u003C\u002Fdiv>\n}\n\nexport function CardBody({ children }: { children: React.ReactNode }) {\n  return \u003Cdiv className=\"card-body\">{children}\u003C\u002Fdiv>\n}\n\n\u002F\u002F 使用方式\n\u003CCard>\n  \u003CCardHeader>標題\u003C\u002FCardHeader>\n  \u003CCardBody>內容\u003C\u002FCardBody>\n\u003C\u002FCard>\n```\n\n### 複合元件\n\n```typescript\ninterface TabsContextValue {\n  activeTab: string\n  setActiveTab: (tab: string) => void\n}\n\nconst TabsContext = createContext\u003CTabsContextValue | undefined>(undefined)\n\nexport function Tabs({ children, defaultTab }: {\n  children: React.ReactNode\n  defaultTab: string\n}) {\n  const [activeTab, setActiveTab] = useState(defaultTab)\n\n  return (\n    \u003CTabsContext.Provider value={{ activeTab, setActiveTab }}>\n      {children}\n    \u003C\u002FTabsContext.Provider>\n  )\n}\n\nexport function TabList({ children }: { children: React.ReactNode }) {\n  return \u003Cdiv className=\"tab-list\">{children}\u003C\u002Fdiv>\n}\n\nexport function Tab({ id, children }: { id: string, children: React.ReactNode }) {\n  const context = useContext(TabsContext)\n  if (!context) throw new Error('Tab must be used within Tabs')\n\n  return (\n    \u003Cbutton\n      className={context.activeTab === id ? 'active' : ''}\n      onClick={() => context.setActiveTab(id)}\n    >\n      {children}\n    \u003C\u002Fbutton>\n  )\n}\n\n\u002F\u002F 使用方式\n\u003CTabs defaultTab=\"overview\">\n  \u003CTabList>\n    \u003CTab id=\"overview\">概覽\u003C\u002FTab>\n    \u003CTab id=\"details\">詳情\u003C\u002FTab>\n  \u003C\u002FTabList>\n\u003C\u002FTabs>\n```\n\n### Render Props 模式\n\n```typescript\ninterface DataLoaderProps\u003CT> {\n  url: string\n  children: (data: T | null, loading: boolean, error: Error | null) => React.ReactNode\n}\n\nexport function DataLoader\u003CT>({ url, children }: DataLoaderProps\u003CT>) {\n  const [data, setData] = useState\u003CT | null>(null)\n  const [loading, setLoading] = useState(true)\n  const [error, setError] = useState\u003CError | null>(null)\n\n  useEffect(() => {\n    fetch(url)\n      .then(res => res.json())\n      .then(setData)\n      .catch(setError)\n      .finally(() => setLoading(false))\n  }, [url])\n\n  return \u003C>{children(data, loading, error)}\u003C\u002F>\n}\n\n\u002F\u002F 使用方式\n\u003CDataLoader\u003CMarket[]> url=\"\u002Fapi\u002Fmarkets\">\n  {(markets, loading, error) => {\n    if (loading) return \u003CSpinner \u002F>\n    if (error) return \u003CError error={error} \u002F>\n    return \u003CMarketList markets={markets!} \u002F>\n  }}\n\u003C\u002FDataLoader>\n```\n\n## 自訂 Hooks 模式\n\n### 狀態管理 Hook\n\n```typescript\nexport function useToggle(initialValue = false): [boolean, () => void] {\n  const [value, setValue] = useState(initialValue)\n\n  const toggle = useCallback(() => {\n    setValue(v => !v)\n  }, [])\n\n  return [value, toggle]\n}\n\n\u002F\u002F 使用方式\nconst [isOpen, toggleOpen] = useToggle()\n```\n\n### 非同步資料取得 Hook\n\n```typescript\ninterface UseQueryOptions\u003CT> {\n  onSuccess?: (data: T) => void\n  onError?: (error: Error) => void\n  enabled?: boolean\n}\n\nexport function useQuery\u003CT>(\n  key: string,\n  fetcher: () => Promise\u003CT>,\n  options?: UseQueryOptions\u003CT>\n) {\n  const [data, setData] = useState\u003CT | null>(null)\n  const [error, setError] = useState\u003CError | null>(null)\n  const [loading, setLoading] = useState(false)\n\n  \u002F\u002F 將最新的 fetcher\u002Foptions 保存在 ref 中，讓 refetch 即使在呼叫端\n  \u002F\u002F 傳入行內函式與物件字面值時也能保持參照穩定。\n  \u002F\u002F 若沒有這麼做，每次渲染都會建立新的 refetch，下方的 effect 會在\n  \u002F\u002F 每次狀態更新後重新執行，造成無限取得迴圈。\n  const fetcherRef = useRef(fetcher)\n  const optionsRef = useRef(options)\n  useEffect(() => {\n    fetcherRef.current = fetcher\n    optionsRef.current = options\n  })\n\n  const refetch = useCallback(async () => {\n    setLoading(true)\n    setError(null)\n\n    try {\n      const result = await fetcherRef.current()\n      setData(result)\n      optionsRef.current?.onSuccess?.(result)\n    } catch (err) {\n      const error = err as Error\n      setError(error)\n      optionsRef.current?.onError?.(error)\n    } finally {\n      setLoading(false)\n    }\n  }, [])\n\n  const enabled = options?.enabled !== false\n\n  useEffect(() => {\n    if (enabled) {\n      refetch()\n    }\n  }, [key, enabled, refetch])\n\n  return { data, error, loading, refetch }\n}\n\n\u002F\u002F 使用方式\nconst { data: markets, loading, error, refetch } = useQuery(\n  'markets',\n  () => fetch('\u002Fapi\u002Fmarkets').then(r => r.json()),\n  {\n    onSuccess: data => console.log('Fetched', data.length, 'markets'),\n    onError: err => console.error('Failed:', err)\n  }\n)\n```\n\n### Debounce Hook\n\n```typescript\nexport function useDebounce\u003CT>(value: T, delay: number): T {\n  const [debouncedValue, setDebouncedValue] = useState\u003CT>(value)\n\n  useEffect(() => {\n    const handler = setTimeout(() => {\n      setDebouncedValue(value)\n    }, delay)\n\n    return () => clearTimeout(handler)\n  }, [value, delay])\n\n  return debouncedValue\n}\n\n\u002F\u002F 使用方式\nconst [searchQuery, setSearchQuery] = useState('')\nconst debouncedQuery = useDebounce(searchQuery, 500)\n\nuseEffect(() => {\n  if (debouncedQuery) {\n    performSearch(debouncedQuery)\n  }\n}, [debouncedQuery])\n```\n\n## 狀態管理模式\n\n### Context + Reducer 模式\n\n```typescript\ninterface State {\n  markets: Market[]\n  selectedMarket: Market | null\n  loading: boolean\n}\n\ntype Action =\n  | { type: 'SET_MARKETS'; payload: Market[] }\n  | { type: 'SELECT_MARKET'; payload: Market }\n  | { type: 'SET_LOADING'; payload: boolean }\n\nfunction reducer(state: State, action: Action): State {\n  switch (action.type) {\n    case 'SET_MARKETS':\n      return { ...state, markets: action.payload }\n    case 'SELECT_MARKET':\n      return { ...state, selectedMarket: action.payload }\n    case 'SET_LOADING':\n      return { ...state, loading: action.payload }\n    default:\n      return state\n  }\n}\n\nconst MarketContext = createContext\u003C{\n  state: State\n  dispatch: Dispatch\u003CAction>\n} | undefined>(undefined)\n\nexport function MarketProvider({ children }: { children: React.ReactNode }) {\n  const [state, dispatch] = useReducer(reducer, {\n    markets: [],\n    selectedMarket: null,\n    loading: false\n  })\n\n  return (\n    \u003CMarketContext.Provider value={{ state, dispatch }}>\n      {children}\n    \u003C\u002FMarketContext.Provider>\n  )\n}\n\nexport function useMarkets() {\n  const context = useContext(MarketContext)\n  if (!context) throw new Error('useMarkets must be used within MarketProvider')\n  return context\n}\n```\n\n## 效能優化\n\n### 記憶化\n\n```typescript\n\u002F\u002F PASS: useMemo 用於昂貴計算\n\u002F\u002F 排序前先複製 - Array.prototype.sort 會就地修改陣列\nconst sortedMarkets = useMemo(() => {\n  return [...markets].sort((a, b) => b.volume - a.volume)\n}, [markets])\n\n\u002F\u002F PASS: useCallback 用於傳遞給子元件的函式\nconst handleSearch = useCallback((query: string) => {\n  setSearchQuery(query)\n}, [])\n\n\u002F\u002F PASS: React.memo 用於純元件\nexport const MarketCard = React.memo\u003CMarketCardProps>(({ market }) => {\n  return (\n    \u003Cdiv className=\"market-card\">\n      \u003Ch3>{market.name}\u003C\u002Fh3>\n      \u003Cp>{market.description}\u003C\u002Fp>\n    \u003C\u002Fdiv>\n  )\n})\n```\n\n### 程式碼分割與延遲載入\n\n```typescript\nimport { lazy, Suspense } from 'react'\n\n\u002F\u002F PASS: 延遲載入重型元件\nconst HeavyChart = lazy(() => import('.\u002FHeavyChart'))\nconst ThreeJsBackground = lazy(() => import('.\u002FThreeJsBackground'))\n\nexport function Dashboard() {\n  return (\n    \u003Cdiv>\n      \u003CSuspense fallback={\u003CChartSkeleton \u002F>}>\n        \u003CHeavyChart data={data} \u002F>\n      \u003C\u002FSuspense>\n\n      \u003CSuspense fallback={null}>\n        \u003CThreeJsBackground \u002F>\n      \u003C\u002FSuspense>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n### 長列表虛擬化\n\n```typescript\nimport { useVirtualizer } from '@tanstack\u002Freact-virtual'\n\nexport function VirtualMarketList({ markets }: { markets: Market[] }) {\n  const parentRef = useRef\u003CHTMLDivElement>(null)\n\n  const virtualizer = useVirtualizer({\n    count: markets.length,\n    getScrollElement: () => parentRef.current,\n    estimateSize: () => 100,  \u002F\u002F 預估行高\n    overscan: 5  \u002F\u002F 額外渲染的項目數\n  })\n\n  return (\n    \u003Cdiv ref={parentRef} style={{ height: '600px', overflow: 'auto' }}>\n      \u003Cdiv\n        style={{\n          height: `${virtualizer.getTotalSize()}px`,\n          position: 'relative'\n        }}\n      >\n        {virtualizer.getVirtualItems().map(virtualRow => (\n          \u003Cdiv\n            key={virtualRow.index}\n            style={{\n              position: 'absolute',\n              top: 0,\n              left: 0,\n              width: '100%',\n              height: `${virtualRow.size}px`,\n              transform: `translateY(${virtualRow.start}px)`\n            }}\n          >\n            \u003CMarketCard market={markets[virtualRow.index]} \u002F>\n          \u003C\u002Fdiv>\n        ))}\n      \u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n## 表單處理模式\n\n### 帶驗證的受控表單\n\n```typescript\ninterface FormData {\n  name: string\n  description: string\n  endDate: string\n}\n\ninterface FormErrors {\n  name?: string\n  description?: string\n  endDate?: string\n}\n\nexport function CreateMarketForm() {\n  const [formData, setFormData] = useState\u003CFormData>({\n    name: '',\n    description: '',\n    endDate: ''\n  })\n\n  const [errors, setErrors] = useState\u003CFormErrors>({})\n\n  const validate = (): boolean => {\n    const newErrors: FormErrors = {}\n\n    if (!formData.name.trim()) {\n      newErrors.name = '名稱為必填'\n    } else if (formData.name.length > 200) {\n      newErrors.name = '名稱必須少於 200 個字元'\n    }\n\n    if (!formData.description.trim()) {\n      newErrors.description = '描述為必填'\n    }\n\n    if (!formData.endDate) {\n      newErrors.endDate = '結束日期為必填'\n    }\n\n    setErrors(newErrors)\n    return Object.keys(newErrors).length === 0\n  }\n\n  const handleSubmit = async (e: React.FormEvent) => {\n    e.preventDefault()\n\n    if (!validate()) return\n\n    try {\n      await createMarket(formData)\n      \u002F\u002F 成功處理\n    } catch (error) {\n      \u002F\u002F 錯誤處理\n    }\n  }\n\n  return (\n    \u003Cform onSubmit={handleSubmit}>\n      \u003Cinput\n        value={formData.name}\n        onChange={e => setFormData(prev => ({ ...prev, name: e.target.value }))}\n        placeholder=\"市場名稱\"\n      \u002F>\n      {errors.name && \u003Cspan className=\"error\">{errors.name}\u003C\u002Fspan>}\n\n      {\u002F* 其他欄位 *\u002F}\n\n      \u003Cbutton type=\"submit\">建立市場\u003C\u002Fbutton>\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Error Boundary 模式\n\n```typescript\ninterface ErrorBoundaryState {\n  hasError: boolean\n  error: Error | null\n}\n\nexport class ErrorBoundary extends React.Component\u003C\n  { children: React.ReactNode },\n  ErrorBoundaryState\n> {\n  state: ErrorBoundaryState = {\n    hasError: false,\n    error: null\n  }\n\n  static getDerivedStateFromError(error: Error): ErrorBoundaryState {\n    return { hasError: true, error }\n  }\n\n  componentDidCatch(error: Error, errorInfo: React.ErrorInfo) {\n    console.error('Error boundary caught:', error, errorInfo)\n  }\n\n  render() {\n    if (this.state.hasError) {\n      return (\n        \u003Cdiv className=\"error-fallback\">\n          \u003Ch2>發生錯誤\u003C\u002Fh2>\n          \u003Cp>{this.state.error?.message}\u003C\u002Fp>\n          \u003Cbutton onClick={() => this.setState({ hasError: false })}>\n            重試\n          \u003C\u002Fbutton>\n        \u003C\u002Fdiv>\n      )\n    }\n\n    return this.props.children\n  }\n}\n\n\u002F\u002F 使用方式\n\u003CErrorBoundary>\n  \u003CApp \u002F>\n\u003C\u002FErrorBoundary>\n```\n\n## 動畫模式\n\n### Framer Motion 動畫\n\n```typescript\nimport { motion, AnimatePresence } from 'framer-motion'\n\n\u002F\u002F PASS: 列表動畫\nexport function AnimatedMarketList({ markets }: { markets: Market[] }) {\n  return (\n    \u003CAnimatePresence>\n      {markets.map(market => (\n        \u003Cmotion.div\n          key={market.id}\n          initial={{ opacity: 0, y: 20 }}\n          animate={{ opacity: 1, y: 0 }}\n          exit={{ opacity: 0, y: -20 }}\n          transition={{ duration: 0.3 }}\n        >\n          \u003CMarketCard market={market} \u002F>\n        \u003C\u002Fmotion.div>\n      ))}\n    \u003C\u002FAnimatePresence>\n  )\n}\n\n\u002F\u002F PASS: Modal 動畫\nexport function Modal({ isOpen, onClose, children }: ModalProps) {\n  return (\n    \u003CAnimatePresence>\n      {isOpen && (\n        \u003C>\n          \u003Cmotion.div\n            className=\"modal-overlay\"\n            initial={{ opacity: 0 }}\n            animate={{ opacity: 1 }}\n            exit={{ opacity: 0 }}\n            onClick={onClose}\n          \u002F>\n          \u003Cmotion.div\n            className=\"modal-content\"\n            initial={{ opacity: 0, scale: 0.9, y: 20 }}\n            animate={{ opacity: 1, scale: 1, y: 0 }}\n            exit={{ opacity: 0, scale: 0.9, y: 20 }}\n          >\n            {children}\n          \u003C\u002Fmotion.div>\n        \u003C\u002F>\n      )}\n    \u003C\u002FAnimatePresence>\n  )\n}\n```\n\n## 無障礙模式\n\n### 鍵盤導航\n\n```typescript\nexport function Dropdown({ options, onSelect }: DropdownProps) {\n  const [isOpen, setIsOpen] = useState(false)\n  const [activeIndex, setActiveIndex] = useState(0)\n\n  const handleKeyDown = (e: React.KeyboardEvent) => {\n    switch (e.key) {\n      case 'ArrowDown':\n        e.preventDefault()\n        setActiveIndex(i => Math.min(i + 1, options.length - 1))\n        break\n      case 'ArrowUp':\n        e.preventDefault()\n        setActiveIndex(i => Math.max(i - 1, 0))\n        break\n      case 'Enter':\n        e.preventDefault()\n        onSelect(options[activeIndex])\n        setIsOpen(false)\n        break\n      case 'Escape':\n        setIsOpen(false)\n        break\n    }\n  }\n\n  return (\n    \u003Cdiv\n      role=\"combobox\"\n      aria-expanded={isOpen}\n      aria-haspopup=\"listbox\"\n      onKeyDown={handleKeyDown}\n    >\n      {\u002F* 下拉選單實作 *\u002F}\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n### 焦點管理\n\n```typescript\nexport function Modal({ isOpen, onClose, children }: ModalProps) {\n  const modalRef = useRef\u003CHTMLDivElement>(null)\n  const previousFocusRef = useRef\u003CHTMLElement | null>(null)\n\n  useEffect(() => {\n    if (isOpen) {\n      \u002F\u002F 儲存目前聚焦的元素\n      previousFocusRef.current = document.activeElement as HTMLElement\n\n      \u002F\u002F 聚焦 modal\n      modalRef.current?.focus()\n    } else {\n      \u002F\u002F 關閉時恢復焦點\n      previousFocusRef.current?.focus()\n    }\n  }, [isOpen])\n\n  return isOpen ? (\n    \u003Cdiv\n      ref={modalRef}\n      role=\"dialog\"\n      aria-modal=\"true\"\n      tabIndex={-1}\n      onKeyDown={e => e.key === 'Escape' && onClose()}\n    >\n      {children}\n    \u003C\u002Fdiv>\n  ) : null\n}\n```\n\n**記住**：現代前端模式能實現可維護、高效能的使用者介面。選擇符合你專案複雜度的模式。\n",{"name":5,"description":7},"main","57e7aa6b6e03bce1a7d7862ba9c2ec312f7f19b5","src\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fzh-TW\u002Fskills\u002Ffrontend-patterns",0,"https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee","https:\u002F\u002Fwithcyril.me\u002F","Hi, I’m Julian Cyril D, a Computer Science and Business Systems student at PSNACET.\r\nI’m passionate about full-stack development, UI\u002FUX design, and building sma","2026-11-04 23:28:50",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add Cyrilthetecchieee\u002Fcyril-code- --skill frontend-patterns",{"tool":39,"command":40},"bunx","bunx skills add Cyrilthetecchieee\u002Fcyril-code- --skill frontend-patterns",{"tool":42,"command":43},"pnpm","pnpm dlx skills add Cyrilthetecchieee\u002Fcyril-code- --skill frontend-patterns","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fdocs\u002Fzh-TW\u002Fskills\u002Ffrontend-patterns\u002FSKILL.md",true,[],[48,57,64,72,79,86],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":52,"licenseFileUrl":53,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":19},"01M7AQV6CYX8RMC78420V9WZ62","webapp-testing","Toolkit for interacting with and testing local web applications using Playwright. Supports verifying frontend functionality, debugging UI behavior, capturing browser screenshots, and viewing browser logs.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fwebapp-testing\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":19},"01M7AQV2895N3S1MEX6K76G6G2","youtube-downloader","Download YouTube videos with customizable quality and format options. Use this skill when the user asks to download, save, or grab YouTube videos. Supports various quality settings (best, 1080p, 720p, 480p, 360p), multiple formats (mp4, webm, mkv), and audio-only downloads as MP3.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fvideo-downloader\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":52,"licenseFileUrl":68,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M7AQTRNX62DNKVZ5GXEHRBKB","theme-factory","Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors\u002Ffonts that you can apply to any artifact that has been creating, or can generate a new theme on-the-fly.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftheme-factory\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M7AQTNNVHAAN9H6DA8T6ZVE0","template-skill","Replace with description of the skill and when Claude should use it.","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftemplate-skill\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M7AQTJ3MQ6AKX152MEX2MYCC","tailored-resume-generator","Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Ftailored-resume-generator\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":52,"licenseFileUrl":90,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M7AQTD7D5MYET2YWG7HG9WM3","slack-gif-creator","Toolkit for creating animated GIFs optimized for Slack, with validators for size constraints and composable animation primitives. This skill applies when users request animated GIFs or emoji animations for Slack from descriptions like \"make me a GIF for Slack of X doing Y\".","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FCyrilthetecchieee\u002Fcyril-code-\u002Fblob\u002Fmain\u002Fsrc\u002Fcyril_code\u002Fassets\u002F.skills_repo\u002Fslack-gif-creator\u002FSKILL.md",[],[]]