[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6NWD75VF8Q0DW6BTX9ST6X0":3,"skill-same:01M6NWD75VF8Q0DW6BTX9ST6X0":69},{"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":26,"publishedAt":42,"linkOnly":43,"markdownContent":44,"markdownBody":45,"frontMatter":46,"refName":47,"commitSha":48,"skillDirectory":49,"forksCount":14,"repositoryHtmlUrl":50,"repositoryHomepageUrl":6,"ownerHtmlUrl":51,"ownerBlogUrl":52,"ownerDescription":53,"updatedAt":54,"install":55,"resources":68},"01M6NWD75VF8Q0DW6BTX9ST6X0","server-components",null,"React Server Components, Suspense boundaries, streaming SSR, partial prerendering patterns for Next.js App Router.","rubicanjr\u002FFinCognis","rubicanjr","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F234912519?v=4","01M6NT156NND8J474G34SB3923","Rubi","01M6NT15B70RWXE1N3YV0BZY8A",0,"MIT","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fserver-components\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口",[27,28,29,30,31,32,33,34,35,36,37,38,39,40,41],"components","server","Server Components","react","ssr","streaming","Next.js","js","router","patterns","next","app","for","app router","suspense","2026-11-10 10:12:30",false,"---\nname: server-components\ndescription: React Server Components, Suspense boundaries, streaming SSR, partial prerendering patterns for Next.js App Router.\n---\n\n# React Server Components\n\nRSC + Next.js App Router patterns for streaming, caching, and minimal client JS.\n\n## RSC vs Client Components Decision Matrix\n\n```\nUse Server Component (default) when:\n  - Fetching data from DB \u002F API\n  - Accessing backend resources (filesystem, secrets)\n  - No interactivity (useState, useEffect, event listeners)\n  - Heavy dependencies (no bundle cost)\n\nUse Client Component (\"use client\") when:\n  - useState \u002F useReducer \u002F useRef\n  - useEffect \u002F lifecycle hooks\n  - Browser APIs (window, navigator, IntersectionObserver)\n  - Event listeners (onClick, onChange)\n  - Third-party client libraries (charts, drag-drop)\n\nRule: Push \"use client\" as LOW in the tree as possible.\n```\n\n## \"use client\" \u002F \"use server\" Directives\n\n```typescript\n\u002F\u002F app\u002Fdashboard\u002Fpage.tsx — Server Component (no directive needed)\nimport { db } from '@\u002Flib\u002Fdb'\nimport { StatsCounter } from '.\u002Fstats-counter' \u002F\u002F client component\n\nexport default async function DashboardPage() {\n  const stats = await db.query.stats.findMany()\n  \u002F\u002F Can pass serializable props to client components\n  return \u003CStatsCounter initialCount={stats.length} \u002F>\n}\n\n\u002F\u002F app\u002Fdashboard\u002Fstats-counter.tsx — Client Component\n'use client'\nimport { useState } from 'react'\n\nexport function StatsCounter({ initialCount }: { initialCount: number }) {\n  const [count, setCount] = useState(initialCount)\n  return \u003Cbutton onClick={() => setCount(c => c + 1)}>{count}\u003C\u002Fbutton>\n}\n\n\u002F\u002F Server Action in separate file\n\u002F\u002F app\u002Factions.ts\n'use server'\nexport async function createItem(formData: FormData) {\n  \u002F\u002F runs on server, called from client\n}\n```\n\n## Suspense Boundary Placement Strategy\n\n```typescript\n\u002F\u002F Place Suspense around slow data — fast data renders immediately\nexport default async function Page() {\n  const fastData = await db.query.config.findFirst()   \u002F\u002F fast: cached\n\n  return (\n    \u003Cdiv>\n      \u003CHeader config={fastData} \u002F>                      {\u002F* instant *\u002F}\n\n      \u003CSuspense fallback={\u003CStatsSkeleton \u002F>}>\n        \u003CSlowStats \u002F>                                   {\u002F* streams in *\u002F}\n      \u003C\u002FSuspense>\n\n      \u003CSuspense fallback={\u003CFeedSkeleton rows={5} \u002F>}>\n        \u003CActivityFeed \u002F>                                {\u002F* streams in *\u002F}\n      \u003C\u002FSuspense>\n    \u003C\u002Fdiv>\n  )\n}\n\nasync function SlowStats() {\n  const stats = await fetch('\u002Fapi\u002Fstats', { cache: 'no-store' })\n    .then(r => r.json())\n  return \u003CStatsGrid stats={stats} \u002F>\n}\n```\n\n## Streaming SSR with loading.tsx\n\n```\napp\u002F\n  dashboard\u002F\n    page.tsx        ← async server component (data fetching)\n    loading.tsx     ← shown while page.tsx is streaming\n    error.tsx       ← shown if page.tsx throws\n    layout.tsx      ← wraps all, always renders immediately\n```\n\n```typescript\n\u002F\u002F app\u002Fdashboard\u002Floading.tsx — instant skeleton, no async needed\nexport default function Loading() {\n  return (\n    \u003Cdiv className=\"animate-pulse space-y-4\">\n      \u003Cdiv className=\"h-8 bg-gray-200 rounded w-1\u002F3\" \u002F>\n      \u003Cdiv className=\"grid grid-cols-3 gap-4\">\n        {Array.from({ length: 3 }).map((_, i) => (\n          \u003Cdiv key={i} className=\"h-24 bg-gray-200 rounded\" \u002F>\n        ))}\n      \u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n## Partial Prerendering (PPR)\n\n```typescript\n\u002F\u002F next.config.ts — enable PPR (Next.js 14+)\nexport default {\n  experimental: { ppr: true },\n}\n\n\u002F\u002F page.tsx — static shell + dynamic holes\nimport { Suspense } from 'react'\nimport { unstable_noStore as noStore } from 'next\u002Fcache'\n\nexport default function ProductPage({ params }: { params: { id: string } }) {\n  return (\n    \u003Cdiv>\n      {\u002F* Static: prerendered at build time *\u002F}\n      \u003CProductShell id={params.id} \u002F>\n\n      {\u002F* Dynamic hole: streams in per request *\u002F}\n      \u003CSuspense fallback={\u003CPriceSkeleton \u002F>}>\n        \u003CLivePrice id={params.id} \u002F>\n      \u003C\u002FSuspense>\n    \u003C\u002Fdiv>\n  )\n}\n\nasync function LivePrice({ id }: { id: string }) {\n  noStore()  \u002F\u002F opt out of caching — always fresh\n  const price = await fetchLivePrice(id)\n  return \u003Cspan>${price}\u003C\u002Fspan>\n}\n```\n\n## Server Actions Patterns\n\n```typescript\n\u002F\u002F app\u002Factions.ts\n'use server'\n\nimport { revalidatePath, revalidateTag } from 'next\u002Fcache'\nimport { redirect } from 'next\u002Fnavigation'\nimport { z } from 'zod'\n\nconst Schema = z.object({\n  title: z.string().min(1).max(200),\n  priority: z.enum(['low', 'medium', 'high']),\n})\n\n\u002F\u002F Form submission action\nexport async function createTask(prevState: unknown, formData: FormData) {\n  const parsed = Schema.safeParse({\n    title: formData.get('title'),\n    priority: formData.get('priority'),\n  })\n\n  if (!parsed.success) {\n    return { error: parsed.error.flatten().fieldErrors }\n  }\n\n  await db.insert(tasks).values(parsed.data)\n  revalidatePath('\u002Ftasks')        \u002F\u002F invalidate cached page\n  revalidateTag('tasks')          \u002F\u002F invalidate tagged fetches\n  redirect('\u002Ftasks')\n}\n\n\u002F\u002F Mutation action (called programmatically)\nexport async function deleteTask(id: string) {\n  await db.delete(tasks).where(eq(tasks.id, id))\n  revalidatePath('\u002Ftasks')\n}\n\n\u002F\u002F Usage in client component\n'use client'\nimport { useFormState, useFormStatus } from 'react-dom'\nimport { createTask } from '.\u002Factions'\n\nfunction SubmitButton() {\n  const { pending } = useFormStatus()\n  return \u003Cbutton disabled={pending}>{pending ? 'Saving...' : 'Save'}\u003C\u002Fbutton>\n}\n\nexport function TaskForm() {\n  const [state, action] = useFormState(createTask, null)\n  return (\n    \u003Cform action={action}>\n      \u003Cinput name=\"title\" \u002F>\n      {state?.error?.title && \u003Cp>{state.error.title}\u003C\u002Fp>}\n      \u003CSubmitButton \u002F>\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Data Fetching in RSC (async components)\n\n```typescript\n\u002F\u002F Fetch with Next.js extended fetch (auto deduplication + caching)\nasync function UserProfile({ id }: { id: string }) {\n  const user = await fetch(`\u002Fapi\u002Fusers\u002F${id}`, {\n    next: { revalidate: 60, tags: ['users', `user-${id}`] },  \u002F\u002F ISR: 60s\n  }).then(r => r.json())\n\n  return \u003Cdiv>{user.name}\u003C\u002Fdiv>\n}\n\n\u002F\u002F Direct DB query (server only — no API round-trip)\nimport { db } from '@\u002Flib\u002Fdb'\nasync function TaskList() {\n  const tasks = await db.query.tasks.findMany({\n    where: (t, { eq }) => eq(t.userId, await getCurrentUserId()),\n    orderBy: (t, { desc }) => [desc(t.createdAt)],\n  })\n  return \u003Cul>{tasks.map(t => \u003Cli key={t.id}>{t.title}\u003C\u002Fli>)}\u003C\u002Ful>\n}\n```\n\n## Cache and Revalidation\n\n```typescript\nimport { unstable_cache } from 'next\u002Fcache'\nimport { cache } from 'react'\n\n\u002F\u002F React cache — deduplicate within a single request\nconst getUser = cache(async (id: string) => {\n  return db.query.users.findFirst({ where: (u, { eq }) => eq(u.id, id) })\n})\n\n\u002F\u002F Next.js unstable_cache — persist across requests (like ISR)\nconst getCachedStats = unstable_cache(\n  async () => db.query.stats.findMany(),\n  ['global-stats'],\n  { revalidate: 300, tags: ['stats'] }   \u002F\u002F 5 min TTL\n)\n\n\u002F\u002F Manual revalidation from Server Action\nimport { revalidateTag, revalidatePath } from 'next\u002Fcache'\nexport async function updateUser(id: string, data: unknown) {\n  await db.update(users).set(data).where(eq(users.id, id))\n  revalidateTag(`user-${id}`)            \u002F\u002F targeted cache bust\n  revalidatePath('\u002Fdashboard')           \u002F\u002F page cache bust\n}\n```\n\n## Parallel Data Fetching in Layouts\n\n```typescript\n\u002F\u002F Parallel: both requests fire simultaneously\nexport default async function Layout({ children }: { children: React.ReactNode }) {\n  const [user, notifications] = await Promise.all([\n    getUser(),\n    getNotifications(),\n  ])\n\n  return (\n    \u003Cdiv>\n      \u003CHeader user={user} notificationCount={notifications.length} \u002F>\n      \u003Cmain>{children}\u003C\u002Fmain>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n## Error Boundary with error.tsx\n\n```typescript\n\u002F\u002F app\u002Fdashboard\u002Ferror.tsx — must be \"use client\"\n'use client'\n\nexport default function Error({\n  error,\n  reset,\n}: {\n  error: Error & { digest?: string }\n  reset: () => void\n}) {\n  return (\n    \u003Cdiv role=\"alert\" className=\"p-6 border border-red-200 rounded-lg\">\n      \u003Ch2 className=\"text-lg font-semibold text-red-800\">Something went wrong\u003C\u002Fh2>\n      \u003Cp className=\"text-red-600 mt-1 text-sm\">\n        {process.env.NODE_ENV === 'development' ? error.message : 'An error occurred'}\n      \u003C\u002Fp>\n      \u003Cbutton onClick={reset} className=\"mt-4 btn btn-sm\">Try again\u003C\u002Fbutton>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n## Common Pitfalls\n\n```typescript\n\u002F\u002F PITFALL 1: Non-serializable props RSC → Client\n\u002F\u002F WRONG: passing functions, class instances, Dates\n\u003CClientComp handler={someFunction} \u002F>     \u002F\u002F functions not serializable\n\u003CClientComp date={new Date()} \u002F>          \u002F\u002F Date not serializable\n\n\u002F\u002F RIGHT: serialize before passing\n\u003CClientComp dateString={date.toISOString()} \u002F>\n\u003CClientComp timestamp={date.getTime()} \u002F>\n\n\u002F\u002F PITFALL 2: Importing server-only code into client component\n\u002F\u002F Add 'server-only' package to throw at build time\nimport 'server-only'  \u002F\u002F add to lib\u002Fdb.ts, lib\u002Fauth.ts\n\n\u002F\u002F PITFALL 3: Hydration mismatch (browser extensions, dynamic dates)\n\u002F\u002F WRONG:\n\u003Cspan>{new Date().toLocaleString()}\u003C\u002Fspan>  \u002F\u002F server\u002Fclient differ\n\n\u002F\u002F RIGHT: suppress or use useEffect\n'use client'\nconst [time, setTime] = useState\u003Cstring>('')\nuseEffect(() => setTime(new Date().toLocaleString()), [])\n```\n","# React Server Components\n\nRSC + Next.js App Router patterns for streaming, caching, and minimal client JS.\n\n## RSC vs Client Components Decision Matrix\n\n```\nUse Server Component (default) when:\n  - Fetching data from DB \u002F API\n  - Accessing backend resources (filesystem, secrets)\n  - No interactivity (useState, useEffect, event listeners)\n  - Heavy dependencies (no bundle cost)\n\nUse Client Component (\"use client\") when:\n  - useState \u002F useReducer \u002F useRef\n  - useEffect \u002F lifecycle hooks\n  - Browser APIs (window, navigator, IntersectionObserver)\n  - Event listeners (onClick, onChange)\n  - Third-party client libraries (charts, drag-drop)\n\nRule: Push \"use client\" as LOW in the tree as possible.\n```\n\n## \"use client\" \u002F \"use server\" Directives\n\n```typescript\n\u002F\u002F app\u002Fdashboard\u002Fpage.tsx — Server Component (no directive needed)\nimport { db } from '@\u002Flib\u002Fdb'\nimport { StatsCounter } from '.\u002Fstats-counter' \u002F\u002F client component\n\nexport default async function DashboardPage() {\n  const stats = await db.query.stats.findMany()\n  \u002F\u002F Can pass serializable props to client components\n  return \u003CStatsCounter initialCount={stats.length} \u002F>\n}\n\n\u002F\u002F app\u002Fdashboard\u002Fstats-counter.tsx — Client Component\n'use client'\nimport { useState } from 'react'\n\nexport function StatsCounter({ initialCount }: { initialCount: number }) {\n  const [count, setCount] = useState(initialCount)\n  return \u003Cbutton onClick={() => setCount(c => c + 1)}>{count}\u003C\u002Fbutton>\n}\n\n\u002F\u002F Server Action in separate file\n\u002F\u002F app\u002Factions.ts\n'use server'\nexport async function createItem(formData: FormData) {\n  \u002F\u002F runs on server, called from client\n}\n```\n\n## Suspense Boundary Placement Strategy\n\n```typescript\n\u002F\u002F Place Suspense around slow data — fast data renders immediately\nexport default async function Page() {\n  const fastData = await db.query.config.findFirst()   \u002F\u002F fast: cached\n\n  return (\n    \u003Cdiv>\n      \u003CHeader config={fastData} \u002F>                      {\u002F* instant *\u002F}\n\n      \u003CSuspense fallback={\u003CStatsSkeleton \u002F>}>\n        \u003CSlowStats \u002F>                                   {\u002F* streams in *\u002F}\n      \u003C\u002FSuspense>\n\n      \u003CSuspense fallback={\u003CFeedSkeleton rows={5} \u002F>}>\n        \u003CActivityFeed \u002F>                                {\u002F* streams in *\u002F}\n      \u003C\u002FSuspense>\n    \u003C\u002Fdiv>\n  )\n}\n\nasync function SlowStats() {\n  const stats = await fetch('\u002Fapi\u002Fstats', { cache: 'no-store' })\n    .then(r => r.json())\n  return \u003CStatsGrid stats={stats} \u002F>\n}\n```\n\n## Streaming SSR with loading.tsx\n\n```\napp\u002F\n  dashboard\u002F\n    page.tsx        ← async server component (data fetching)\n    loading.tsx     ← shown while page.tsx is streaming\n    error.tsx       ← shown if page.tsx throws\n    layout.tsx      ← wraps all, always renders immediately\n```\n\n```typescript\n\u002F\u002F app\u002Fdashboard\u002Floading.tsx — instant skeleton, no async needed\nexport default function Loading() {\n  return (\n    \u003Cdiv className=\"animate-pulse space-y-4\">\n      \u003Cdiv className=\"h-8 bg-gray-200 rounded w-1\u002F3\" \u002F>\n      \u003Cdiv className=\"grid grid-cols-3 gap-4\">\n        {Array.from({ length: 3 }).map((_, i) => (\n          \u003Cdiv key={i} className=\"h-24 bg-gray-200 rounded\" \u002F>\n        ))}\n      \u003C\u002Fdiv>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n## Partial Prerendering (PPR)\n\n```typescript\n\u002F\u002F next.config.ts — enable PPR (Next.js 14+)\nexport default {\n  experimental: { ppr: true },\n}\n\n\u002F\u002F page.tsx — static shell + dynamic holes\nimport { Suspense } from 'react'\nimport { unstable_noStore as noStore } from 'next\u002Fcache'\n\nexport default function ProductPage({ params }: { params: { id: string } }) {\n  return (\n    \u003Cdiv>\n      {\u002F* Static: prerendered at build time *\u002F}\n      \u003CProductShell id={params.id} \u002F>\n\n      {\u002F* Dynamic hole: streams in per request *\u002F}\n      \u003CSuspense fallback={\u003CPriceSkeleton \u002F>}>\n        \u003CLivePrice id={params.id} \u002F>\n      \u003C\u002FSuspense>\n    \u003C\u002Fdiv>\n  )\n}\n\nasync function LivePrice({ id }: { id: string }) {\n  noStore()  \u002F\u002F opt out of caching — always fresh\n  const price = await fetchLivePrice(id)\n  return \u003Cspan>${price}\u003C\u002Fspan>\n}\n```\n\n## Server Actions Patterns\n\n```typescript\n\u002F\u002F app\u002Factions.ts\n'use server'\n\nimport { revalidatePath, revalidateTag } from 'next\u002Fcache'\nimport { redirect } from 'next\u002Fnavigation'\nimport { z } from 'zod'\n\nconst Schema = z.object({\n  title: z.string().min(1).max(200),\n  priority: z.enum(['low', 'medium', 'high']),\n})\n\n\u002F\u002F Form submission action\nexport async function createTask(prevState: unknown, formData: FormData) {\n  const parsed = Schema.safeParse({\n    title: formData.get('title'),\n    priority: formData.get('priority'),\n  })\n\n  if (!parsed.success) {\n    return { error: parsed.error.flatten().fieldErrors }\n  }\n\n  await db.insert(tasks).values(parsed.data)\n  revalidatePath('\u002Ftasks')        \u002F\u002F invalidate cached page\n  revalidateTag('tasks')          \u002F\u002F invalidate tagged fetches\n  redirect('\u002Ftasks')\n}\n\n\u002F\u002F Mutation action (called programmatically)\nexport async function deleteTask(id: string) {\n  await db.delete(tasks).where(eq(tasks.id, id))\n  revalidatePath('\u002Ftasks')\n}\n\n\u002F\u002F Usage in client component\n'use client'\nimport { useFormState, useFormStatus } from 'react-dom'\nimport { createTask } from '.\u002Factions'\n\nfunction SubmitButton() {\n  const { pending } = useFormStatus()\n  return \u003Cbutton disabled={pending}>{pending ? 'Saving...' : 'Save'}\u003C\u002Fbutton>\n}\n\nexport function TaskForm() {\n  const [state, action] = useFormState(createTask, null)\n  return (\n    \u003Cform action={action}>\n      \u003Cinput name=\"title\" \u002F>\n      {state?.error?.title && \u003Cp>{state.error.title}\u003C\u002Fp>}\n      \u003CSubmitButton \u002F>\n    \u003C\u002Fform>\n  )\n}\n```\n\n## Data Fetching in RSC (async components)\n\n```typescript\n\u002F\u002F Fetch with Next.js extended fetch (auto deduplication + caching)\nasync function UserProfile({ id }: { id: string }) {\n  const user = await fetch(`\u002Fapi\u002Fusers\u002F${id}`, {\n    next: { revalidate: 60, tags: ['users', `user-${id}`] },  \u002F\u002F ISR: 60s\n  }).then(r => r.json())\n\n  return \u003Cdiv>{user.name}\u003C\u002Fdiv>\n}\n\n\u002F\u002F Direct DB query (server only — no API round-trip)\nimport { db } from '@\u002Flib\u002Fdb'\nasync function TaskList() {\n  const tasks = await db.query.tasks.findMany({\n    where: (t, { eq }) => eq(t.userId, await getCurrentUserId()),\n    orderBy: (t, { desc }) => [desc(t.createdAt)],\n  })\n  return \u003Cul>{tasks.map(t => \u003Cli key={t.id}>{t.title}\u003C\u002Fli>)}\u003C\u002Ful>\n}\n```\n\n## Cache and Revalidation\n\n```typescript\nimport { unstable_cache } from 'next\u002Fcache'\nimport { cache } from 'react'\n\n\u002F\u002F React cache — deduplicate within a single request\nconst getUser = cache(async (id: string) => {\n  return db.query.users.findFirst({ where: (u, { eq }) => eq(u.id, id) })\n})\n\n\u002F\u002F Next.js unstable_cache — persist across requests (like ISR)\nconst getCachedStats = unstable_cache(\n  async () => db.query.stats.findMany(),\n  ['global-stats'],\n  { revalidate: 300, tags: ['stats'] }   \u002F\u002F 5 min TTL\n)\n\n\u002F\u002F Manual revalidation from Server Action\nimport { revalidateTag, revalidatePath } from 'next\u002Fcache'\nexport async function updateUser(id: string, data: unknown) {\n  await db.update(users).set(data).where(eq(users.id, id))\n  revalidateTag(`user-${id}`)            \u002F\u002F targeted cache bust\n  revalidatePath('\u002Fdashboard')           \u002F\u002F page cache bust\n}\n```\n\n## Parallel Data Fetching in Layouts\n\n```typescript\n\u002F\u002F Parallel: both requests fire simultaneously\nexport default async function Layout({ children }: { children: React.ReactNode }) {\n  const [user, notifications] = await Promise.all([\n    getUser(),\n    getNotifications(),\n  ])\n\n  return (\n    \u003Cdiv>\n      \u003CHeader user={user} notificationCount={notifications.length} \u002F>\n      \u003Cmain>{children}\u003C\u002Fmain>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n## Error Boundary with error.tsx\n\n```typescript\n\u002F\u002F app\u002Fdashboard\u002Ferror.tsx — must be \"use client\"\n'use client'\n\nexport default function Error({\n  error,\n  reset,\n}: {\n  error: Error & { digest?: string }\n  reset: () => void\n}) {\n  return (\n    \u003Cdiv role=\"alert\" className=\"p-6 border border-red-200 rounded-lg\">\n      \u003Ch2 className=\"text-lg font-semibold text-red-800\">Something went wrong\u003C\u002Fh2>\n      \u003Cp className=\"text-red-600 mt-1 text-sm\">\n        {process.env.NODE_ENV === 'development' ? error.message : 'An error occurred'}\n      \u003C\u002Fp>\n      \u003Cbutton onClick={reset} className=\"mt-4 btn btn-sm\">Try again\u003C\u002Fbutton>\n    \u003C\u002Fdiv>\n  )\n}\n```\n\n## Common Pitfalls\n\n```typescript\n\u002F\u002F PITFALL 1: Non-serializable props RSC → Client\n\u002F\u002F WRONG: passing functions, class instances, Dates\n\u003CClientComp handler={someFunction} \u002F>     \u002F\u002F functions not serializable\n\u003CClientComp date={new Date()} \u002F>          \u002F\u002F Date not serializable\n\n\u002F\u002F RIGHT: serialize before passing\n\u003CClientComp dateString={date.toISOString()} \u002F>\n\u003CClientComp timestamp={date.getTime()} \u002F>\n\n\u002F\u002F PITFALL 2: Importing server-only code into client component\n\u002F\u002F Add 'server-only' package to throw at build time\nimport 'server-only'  \u002F\u002F add to lib\u002Fdb.ts, lib\u002Fauth.ts\n\n\u002F\u002F PITFALL 3: Hydration mismatch (browser extensions, dynamic dates)\n\u002F\u002F WRONG:\n\u003Cspan>{new Date().toLocaleString()}\u003C\u002Fspan>  \u002F\u002F server\u002Fclient differ\n\n\u002F\u002F RIGHT: suppress or use useEffect\n'use client'\nconst [time, setTime] = useState\u003Cstring>('')\nuseEffect(() => setTime(new Date().toLocaleString()), [])\n```\n",{"name":5,"description":7},"main","70e1c350500ee750987420bbae48837afa906b7e","skills\u002Fserver-components","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis","https:\u002F\u002Fgithub.com\u002Frubicanjr","linktr.ee\u002Ffinanskodu","Industrial Engineer & CIO @FinansKodu. Architecting AI-driven financial agents and autonomous workflows. 🏗️ Building systems, not just prompts.","2026-06-09 13:50:15",{"source":8,"skillName":5,"commands":56,"prompt":66,"zipAvailable":67},[57,60,63],{"tool":58,"command":59},"npx","npx skills add rubicanjr\u002FFinCognis --skill server-components",{"tool":61,"command":62},"bunx","bunx skills add rubicanjr\u002FFinCognis --skill server-components",{"tool":64,"command":65},"pnpm","pnpm dlx skills add rubicanjr\u002FFinCognis --skill server-components","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fserver-components\u002FSKILL.md",true,[],[70,88,97,116,143,162],{"skillNo":71,"name":72,"nameZh":6,"description":73,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":74,"categories":75,"keywords":79,"publishedAt":42},"01M6NWS9DAXJTADT4T5MB49X8W","workflow-router","Goal-based workflow orchestration - routes tasks to specialist agents based on user goals","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fworkflow-router\u002FSKILL.md",[76],{"categoryNo":77,"categoryName":78,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[80,81,35,82,83,84,85,86,87],"workflow router","workflow","orchestration","goals","goal","user","workflow orchestration","tasks",{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":42},"01M6NWS3RETSC0SHP16HP66E14","wiring","Wiring Verification","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fwiring\u002FSKILL.md",[],[90,95,96],"verification","false",{"skillNo":98,"name":99,"nameZh":6,"description":100,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":101,"categories":102,"keywords":106,"publishedAt":42},"01M6NWS0XW9CVQZBDA1EGW0TWC","websocket-patterns","Connection management, room patterns, reconnection strategies, message buffering, and binary protocol design.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fwebsocket-patterns\u002Fskill.md",[103],{"categoryNo":104,"categoryName":105,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000015","视觉设计",[107,36,108,109,110,111,112,113,114,115],"websocket","websocket patterns","design","protocol","management","message","strategies","binary","connection",{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":124,"publishedAt":42},"01M6NWRDQDX9ZNETAWRRMQWV52","visual-verdict","Screenshot comparison QA for frontend development. Takes a screenshot of the current implementation, scores it across multiple visual dimensions, and returns a structured PASS\u002FREVISE\u002FFAIL verdict with concrete fixes. Use when implementing UI from a design reference or verifying visual correctness.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fvisual-verdict\u002FSKILL.md",[122,123],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},{"categoryNo":77,"categoryName":78,"taxonomyType":21,"taxonomyTypeDesc":22},[125,126,127,128,129,130,131,132,133,39,134,135,136,109,137,138,139,140,141,142],"visual","verdict","visual verdict","ui","across","revise","comparison","correctness","implementing","fixes","dimensions","frontend","development","qa","screenshot","returns","use","frontend development",{"skillNo":144,"name":145,"nameZh":6,"description":146,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":147,"categories":148,"keywords":149,"publishedAt":42},"01M6NWR8HSNRS7MNDK2J02QYMN","verification-loop","Comprehensive verification system covering build, types, lint, tests, security, and diff review before a PR.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fverification-loop\u002FSKILL.md",[],[150,151,95,152,153,154,155,156,157,158,159,160,161],"verification loop","loop","lint","review","security","pr","system","diff","build","tests","diff review","types",{"skillNo":163,"name":164,"nameZh":6,"description":165,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":166,"categories":167,"keywords":168,"publishedAt":42},"01M6NWR4HHSFR0VR5EXFRWA747","vector-db-patterns","Embedding strategies, ANN algorithms, hybrid search, RAG chunking strategies, and reranking for semantic search and retrieval.","https:\u002F\u002Fgithub.com\u002Frubicanjr\u002FFinCognis\u002Fblob\u002Fmain\u002Fskills\u002Fvector-db-patterns\u002Fskill.md",[],[169,170,171,172,36,173,174,175,176,113,177,178,179,180,181,39,182,183],"vector db patterns","vector db","db","vector","semantic search","search","embedding strategies","algorithms","chunking","semantic","retrieval","embedding","Hybrid Search","hybrid","rag"]