Iván
作者:Iván更新於 2026-07-26共 8 個版本 · 最新版本釋出於 2026-07-26react@clawhub_ivangdavila/react
程式碼生成測試生成前端開發

據 AlphaMoat 統計,截至 2026-10,React 累計下載 11,359 次、獲 3 個星標,按累計下載量在本次參與排名的 10,914 個 AI 技能中排名第 2,418 位,在「開發程式設計」分類(1,069 個)中排名第 174 位。

列表預設按累計下載量排序,也可按星標排序;詳情頁排名按累計下載量計算。

累計下載
1.1萬
星標
3
全站下載量排名
#2,418
全站前 23% · 「開發程式設計」前 17%
平台累計下載星標評論
ClawHub ↗97863-
SkillHub ↗1.1萬3—

各平台的計數口徑不同,統計時間不一致。

這個技能是做什麼的

覆蓋元件、功能與整體架構的搭建,以及在 useState、Context、Zustand、TanStack Query 等方案之間做狀態選型。涉及 React 19 的服務端元件、use()、Actions 與編譯器時給出對應寫法。強調派生值在渲染中計算,不要放進 effect。 生成的建議僅供起點參考;依專案環境和可靠來源核實版本細節與事實,不要把範例當作實測結果。

資料釋出於 2026-10-27

可以用來做什麼

  • 為一個新功能選擇狀態管理方案並接入。
  • 把一段舊程式碼遷移到服務端元件寫法。

什麼時候用

  • 寫或重構 React 元件時。
  • 在多種狀態方案之間拿不定主意時。

示例提示詞

以下是根據技能文件生成的示例,不代表實際執行結果。

幫我看看這個功能該用哪種狀態管理方案。
把這段元件改成服務端元件寫法。

月度資料趨勢

累計下載1.1萬
474182951.2萬2026-03 · 累計下載 52312026-05 · 累計下載 67522026-06 · 累計下載 71402026-07 · 累計下載 81172026-08 · 累計下載 89352026-09 · 累計下載 93582026-10 · 累計下載 1.1萬26-0326-0926-10
星標3
2342026-03 · 星標 32026-05 · 星標 32026-06 · 星標 32026-07 · 星標 32026-08 · 星標 32026-09 · 星標 32026-10 · 星標 326-0326-0926-10

2026-09 起統計方法調整:同名技能按作者分別統計,並覆蓋全部技能。圖中虛線為調整前的月份,與之後的資料不直接比較,也不計算跨越調整的增長。

月份累計下載環比星標
2026-101.1萬—3
2026-099358—3
2026-088935+10.1%3
2026-078117+13.7%3
2026-067140+5.7%3
2026-056752—3
2026-035231—3

SKILL.md 原文

以下是作者釋出的原始檔案,按純文字顯示,本站未做修改或稽核;其中的連結不可點選,命令請核實後再執行。抓取於 2026-10-23。

17 KB · ClawHub v1.0.7
---
name: React
slug: react
version: 1.0.7
description: >-
  Builds, debugs, and reviews React apps: components, hooks, state, Server Components, forms, performance, testing.
  Use when writing or refactoring components, choosing state management (useState, Context, Zustand, TanStack Query, Redux),
  when a component rerenders too often, loops infinitely ("too many re-renders"), shows stale or not-updating state, fails
  with a hydration mismatch or hook-order error, when an effect fires twice or fetches race, when typing lags or long lists
  scroll slowly, when adopting React 19, Server Actions, or the React Compiler, when testing components with Testing Library,
展開全部(共 239 行)
  typing props in TypeScript, or reviewing AI-generated React code. Not for React Native (mobile) or Next.js routing and
  deployment — use react-native or nextjs.
homepage: https://clawic.com/skills/react
changelog: "Display name shown correctly"
metadata:
  clawdbot:
    emoji: ⚛️
    displayName: React
    requires:
      bins:
      - node
    configPaths:
    - ~/Clawic/data/react/
---

User preferences and memory live in `~/Clawic/data/react/` (see `setup.md` on first use, `memory-template.md` for the file format). If you have data at an old location (`~/react/` or `~/clawic/react/`), move it to `~/Clawic/data/react/`.

## When To Use

- Building React components, features, or app architecture
- Choosing or wiring state (useState, Context, Zustand, TanStack Query)
- Working with React 19: Server Components, use(), Actions, React Compiler
- Debugging rerenders, infinite loops, stale closures, hydration errors, racing fetches
- Testing components, typing props, migrating legacy React code
- Reviewing AI-generated React for the failure patterns listed here
- Not for routing/deployment specifics (nextjs skill) or mobile (react-native skill)

## Quick Reference

| Situation | Play |
|----------|------|
| Data comes from an API | TanStack Query — never useState + useEffect fetch (`state.md`) |
| UI state shared across components | Zustand slice, read via selectors only (`state.md`) |
| State used by one component | useState, colocated; lift at the second consumer, not before |
| Rarely-changing globals (theme, locale, auth identity) | Context with memoized value; split state and dispatch contexts |
| Filters, tabs, page number the user could bookmark | URL searchParams, not useState (`state.md`) |
| Form with validation | React Hook Form + Zod (uncontrolled: keystrokes don't rerender); server mutation → useActionState (`forms.md`) |
| Typing lags in a filtered view | useDeferredValue around the value you receive; startTransition around state you set |
| List with thousands of rows | Virtualize (tanstack-virtual) — DOM node count is the cost, not data size |
| Component must reset when identity changes | Change its `key`: `<Profile key={userId} />` — remount beats manual state clearing |
| Multi-step flow / wizard | One discriminated-union status field, not a pile of booleans (`forms.md`) |
| A crash blanks the whole app | react-error-boundary per route and per risky feature |
| Same component commits repeatedly, props unchanged | Profile before touching code (`performance.md`) |
| Infinite loop, stale state, hydration error | Symptom chains in `debug.md` |
| Class components, forwardRef, PropTypes in the codebase | `migration.md` before adding features on top |
| Anything else / unsure | useState colocated, named export; extract when a second consumer appears |

Depth on demand: `debug.md` symptom→cause chains · `state.md` server/client/URL state · `server-components.md` RSC boundaries and Actions · `hooks.md` effect discipline, refs, custom hooks · `performance.md` profiling and fixes in priority order · `forms.md` validation, wizards, uploads · `testing.md` Testing Library, MSW, async · `typescript.md` typing patterns · `accessibility.md` focus, ARIA, keyboard · `migration.md` upgrades and legacy code · `setup.md` scaffolding and recommended stack.

## Core Rules

1. **Server state ≠ client state.** API data lives in TanStack Query (a cache with a lifecycle); UI state in useState/Zustand. Mixing them means hand-rebuilding dedupe, caching, and invalidation — badly.
2. **No effect without an external system.** Derivable from props/state → compute in render: `const total = items.reduce(...)`. Before writing useEffect ask "what outside React am I synchronizing with?" No answer → no effect (`hooks.md` for the full replacement table).
3. **`'use client'` marks a boundary, not a component.** Everything that file imports joins the client bundle. Put it on leaf interactive components; pass Server Components through as `children`.
4. **Stable keys — and keys as a tool.** `key={item.id}` for lists; deliberately changing a key is the sanctioned way to reset component state.
5. **Named exports only.** `export function UserCard` — rename refactors stay safe, imports stay greppable.
6. **Memoize by evidence.** React Compiler on: write no memo/useMemo/useCallback by hand — the compiler bails out on components that break the Rules of React, it doesn't fix them. Compiler off: memoize only after the Profiler shows the same component committing repeatedly with unchanged props.
7. **`strict: true` plus `noUncheckedIndexedAccess`.** With it, `array[0]` is `T | undefined` — the "impossible" runtime crash becomes a compile error.
8. **Split at ~50 lines of JSX or ~300 lines per file** (house default, not dogma): past that, the extraction candidates are already visible in the markup.

## Error Messages Decoded

| Error | Cause | First move |
|-------|-------|-----------|
| "Too many re-renders" | setState called during render, unconditionally | Find the bare `setX(...)` in the body or an `onClick={fn()}` call instead of `onClick={fn}` |
| "Rendered more hooks than during the previous render" | Conditional hook, or early return above a hook | Move every early return below the last hook (Component Rules) |
| "Invalid hook call" | Hook outside a component/custom hook — or two React copies | `npm ls react`; monorepos and linked packages duplicate React silently |
| "Objects are not valid as a React child" | Rendering `{user}` or `{date}` instead of a field | Render primitives: `{user.name}`, `{date.toISOString()}` |
| "Each child in a list should have a unique key" | Missing or duplicate keys | `key={item.id}` (rule 4); duplicates mean the data has duplicate ids — fix the data |
| "Hydration failed" / "Text content does not match" | Server and client rendered different markup | Chain in `debug.md` — Date/random/locale, invalid HTML nesting, browser extensions |
| "Cannot update a component while rendering a different component" | setState on another component during render | Move the setState into an event handler or effect |
| Minified React error #NNN | Production build strips messages | Decode at react.dev/errors/NNN, then reproduce in dev |

## Component Rules

```tsx
export function UserCard({ user, onEdit }: UserCardProps) {
  // 1. Hooks first, unconditional
  const [isOpen, setIsOpen] = useState(false)
  // 2. Derived values in render — never in an effect
  const fullName = `${user.firstName} ${user.lastName}`
  // 3. Handlers
  const handleEdit = () => onEdit(user.id)
  // 4. Early returns AFTER all hooks
  if (!user.isVisible) return null
  // 5. JSX
  return (...)
}
```

Export the props interface (`typescript.md` for variant props, generics, event types). Early returns must come after every hook call — a conditional return above a hook changes hook order between renders and crashes.

## State Management

```
Is it from an API?
├─ YES → TanStack Query (not Redux, not Zustand, not Context)
└─ NO → Should it survive refresh / be shareable? → URL searchParams
    └─ NO → Shared across components?
        ├─ YES → Zustand (changes often) or Context (rarely changes)
        └─ NO → useState
```

Load-bearing defaults (full patterns, pagination, optimistic updates, persistence: `state.md`):

- **TanStack Query >=5**: staleTime defaults to 0 — every mount and window refocus refetches. Set it per resource: staleTime = how stale the user can tolerate that data. Keep gcTime (default 5 min) ≥ staleTime. Query keys come from a key factory, one source of truth.
- **Zustand >=5**: read with selectors — bare `useStore()` rerenders on every store change; selectors returning fresh objects need `useShallow`. One store per concern — a god-store recreates Redux without the devtools.
- **Context**: every value change rerenders every consumer, no selectors. Memoize the value object; split state and dispatch into two contexts so setter-only consumers never rerender.

## React 19

- **Server Components** render on the server, ship zero JS; client components are the interactive leaves. Serialization rules, streaming, and Server Actions: `server-components.md`.
- **`use(promise)`** suspends until resolved and may be called conditionally — the one exception to hook rules. Never create the promise inside a client render (new promise each render suspends forever): create it in the parent or cache it.
- **`ref` is a normal prop** — forwardRef is no longer needed. **`<Context>`** renders as a provider directly. Migration of legacy patterns: `migration.md`.
- **Actions**: `useActionState(action, initial)` returns `[state, formAction, pending]`; `useFormStatus` reads pending from any child of the form — no prop drilling into submit buttons; `useOptimistic` renders the optimistic value and reverts automatically on throw. Worked form example: `forms.md`.

## Performance

Order of operations — measure before touching code (workflow in `performance.md`):

| Priority | Technique | When |
|----------|-----------|------|
| P0 | Route-based code splitting (`lazy` + Suspense) | Always — users pay only for the route they visit |
| P0 | Parallel data loading (`Promise.all`, prefetch) | Any page with 2+ independent fetches — waterfalls dominate load time |
| P1 | Virtualize long lists | Thousands of rows or hundreds of complex rows — profile, DOM nodes are the cost |
| P1 | useDeferredValue / startTransition | Typing or dragging feels janky because a heavy subtree rerenders per keystroke |
| P2 | memo / useMemo by Profiler evidence | Only without React Compiler (→ Core Rule 6) |

## Output Gates

Before emitting a component or review verdict, verify:

- Every list key a stable identity, never the index on reorderable data?
- Every useEffect names an external system; derivable values computed in render?
- `'use client'` only on interactive leaves; no server-only import crossing the boundary?
- Mutations invalidate or update their query keys?
- Interactive elements are native (`button`, `a`, `label`) with accessible names?
- Error path rendered — boundary or explicit error state, not just the happy path?
- New abstraction has a second consumer, or stays concrete?

## Configuration

User-dependent variables. Defaults apply until the user states a preference; store them in `~/Clawic/data/react/config.yaml`.

| Variable | Type | Default | Effect |
|---|---|---|---|
| framework | nextjs \| vite \| remix | nextjs | Selects RSC vs SPA guidance: Server Components/Actions sections apply only under an RSC framework; vite switches examples to client-only patterns |
| styling | tailwind \| css-modules \| styled-components | tailwind | Styling used in every component example and scaffold |
| state_library | zustand \| redux-toolkit \| jotai | zustand | Client-state recommendations and store examples in State Management |
| package_manager | npm \| pnpm \| yarn \| bun | npm | Install and script commands in setup and examples |

Preference areas to record as the user reveals them:

- **tooling** — test runner (Vitest/Jest), lint/format stack, monorepo layout — affects `testing.md` examples and scaffold commands
- **conventions** — file naming, folder structure, component patterns beyond the named-export rule — affects generated file layout
- **platform** — SSR requirements, target browsers, deployment target — affects hydration guidance and performance budgets
- **safety posture** — how aggressively to flag legacy patterns and AI mistakes during review (rewrite vs comment) — affects review behavior

Per-project facts (React version, Compiler on/off, stack deviations) belong in `memory.md`, not config — they change per repo, not per user.

## Traps

| Trap | Why it fails | Do instead |
|------|--------------|------------|
| `{count && <X />}` | `0` is falsy but renderable — the page shows a literal 0 | `{count > 0 && <X />}` |
| `key={index}` on lists that reorder/filter | State and DOM stick to the position, not the item — inputs show the wrong values | `key={item.id}` |
| Object/array literal in effect deps | Fresh reference every render → effect fires every render | Depend on primitives, or memoize upstream |
| Mutating state then setState | Same reference — React skips the rerender | New reference: `setArray([...array, item])` |
| Fetch in effect without cancellation | Slow response for the old value overwrites fast response for the new one | `AbortController` in cleanup (below) |
| "My effect runs twice" → deleting StrictMode | Double-mount is dev-only and deliberate: it exposes missing cleanup | Fix the cleanup; keep StrictMode |
| Expecting error boundaries to catch handler/async errors | Boundaries only catch render and lifecycle errors | try/catch in handlers; `onError` in mutations |
| Hydration mismatch | `Date.now()`, `Math.random()`, locale formatting, `typeof window` branches render differently on server vs client | Move to an effect, or `suppressHydrationWarning` on that single element |
| setState during render | Render → setState → render, infinite loop | Compute derived values inline; setState in handlers/effects |
| `useEffect(async () => …)` | Effect must return cleanup or nothing, not a promise | Define an async fn inside and call it |
| Reading state right after setState | State is a snapshot per render — the variable still holds the old value | Use the value you passed, or a functional update; effects react to the next render |

```tsx
// Cancellation — the race-condition fix
useEffect(() => {
  const controller = new AbortController()
  fetch(url, { signal: controller.signal })
    .then((r) => r.json())
    .then(setData)
    .catch((e) => { if (e.name !== 'AbortError') setError(e) })
  return () => controller.abort()
}, [url])
```

## AI Mistakes to Avoid

Patterns generated code gets wrong — check these when reviewing:

| Mistake | Correct pattern |
|---------|-----------------|
| useEffect + useState to derive a value | Compute inline in render (→ Core Rule 2) |
| Fetching in useEffect | TanStack Query, or promise + use() under Suspense |
| Redux/Context for API data | TanStack Query — server state is a cache, not app state |
| Default exports | Named exports (→ Core Rule 5) |
| useCallback/useMemo on everything | Compiler on: none by hand; off: Profiler evidence first (→ Core Rule 6) |
| Generic abstraction on first use (`<DataTable>` for one table) | Write it concrete; abstract at the second real consumer |
| Giant components | Split at ~50 JSX / ~300 file lines (→ Core Rule 8) |
| No error boundaries anywhere | Route level + each risky feature |
| Scattered `any` to silence strict mode | Fix the type; `unknown` + narrowing when truly dynamic (`typescript.md`) |
| `<div onClick>` for interactive elements | Native `button`/`a` — keyboard and focus come free (`accessibility.md`) |
| Testing implementation details (state values, mock call counts) | Test what the user sees: roles, labels, visible output (`testing.md`) |

## Where Experts Disagree

- **Memoize-by-default vs profile-first.** The React Compiler settles it for new code (write none). For pre-compiler codebases: libraries and design systems memoize exports defensively (unknown consumers); apps profile first.
- **RSC-everything vs SPA.** Content and commerce sites win with Server Components (payload, SEO). Dashboard-dense apps behind a login with constant interactivity lose little by staying SPA (Vite) — don't pay the RSC mental tax for zero SEO benefit.
- **Zustand vs Context for shared state.** Context is fine while values change rarely; the crossover is update frequency, not app size. Frequent updates through Context force consumer-tree rerenders that selectors avoid.
- **Feature folders vs type folders.** Type folders (`components/`, `hooks/`) survive only in small apps; beyond a handful of features, colocation by feature keeps change surface local. Default to feature folders (→ setup.md).
- **Form libraries vs platform forms.** A login form needs no library — useActionState + FormData is enough. The crossover is client-side validation complexity and dynamic fields, not form count (`forms.md`).

## Related Skills
More Clawic skills, get them at https://clawic.com/skills/react (install if the user confirms):

- `frontend-design-ultimate` — complete UIs with React + Tailwind
- `typescript` — TypeScript beyond component typing: generics, tsconfig, declaration files
- `nextjs` — Next.js App Router, caching, and deployment
- `testing` — testing strategy beyond components

## Feedback

- If useful, star it: https://clawic.com/skills/react
- Latest version: https://clawic.com/skills/react

Part of [Clawic](https://clawic.com), the verified skill library. Get this skill: https://clawic.com/skills/react.

「開發程式設計」分類下的熱門技能

程式設計大神.Skill開發程式設計

【全棧能力】程式設計大神.Skill:面向複雜真實專案的高階全棧程式設計助手。不止生成程式碼,而是從一句目標接手陌生程式碼庫,拆解需求、補齊實現、追到根因、完成重構、聯調前後端,並把結果推進到能執行、能驗證、能交付。覆蓋 Web、後端、指令碼、iOS、安卓、鴻蒙 ArkUI、微信小程式及其他技術棧,支援中英文工程、疑難 Bug、跨模組任務和長任務續做;用構建、日誌、真實入口、裝置或介面證據說明結果。僅問概念時直接回答,要求落地時持續推進到驗收或明確阻塞。

↓ 1125.9萬★ 82u_42bbb65f
程式設計專家Pro.Skill開發程式設計

程式設計專家 Pro:融合程式設計專家 2.0.3 工程專題與程式設計大神的鴻蒙 ArkTS/ArkUI、微信小程式和小遊戲開發資料。用於專案實現、根因除錯、審查、重構、測試、架構效能分析及多端開發驗證。支援自然語言和 @專題標識,按任務讀取包內知識;只問概念時直接回答。

↓ 626.9萬★ 32user_47d655f0
程式設計專家.Skill開發程式設計

程式設計專家.Skill P8級程式設計助手,25年實戰經驗技能Skill,全棧:Java/Php網站/軟體專案、API設計、Bug診斷、程式碼生成、程式碼審查、重構、測試用例、效能基準、技術選型、文件生成、任務拆解、Spec驅動、Karpathy規範、CMS二次開發、前端設計、MySQL/Mariadb、專案知識圖譜,以及工程紀律層(根因除錯硬閉環、階段導航、事故復盤/SLO、威脅建模/供應鏈安全、生產就緒/漸進式釋出、AI編碼治理、面向Agent程式碼可讀性、LLM應用安全)。支援 @標識 顯式呼叫跳過路由。

↓ 600.7萬★ 378user_741dc82b
dev-expert開發程式設計

程式設計專家.Skill P8級程式設計助手,25年實戰經驗技能Skill,全棧:Java/Php網站/軟體專案、API設計、Bug診斷、程式碼生成、程式碼審查、重構、測試用例、效能基準、技術選型、文件生成、任務拆解、Spec驅動、Karpathy規範、CMS二次開發、前端設計、MySQL/Mariadb、專案知識圖譜,以及工程紀律層(根因除錯硬閉環、階段導航、事故復盤/SLO、威脅建模/供應鏈安全、生產就緒/漸進式釋出、AI編碼治理、面向Agent程式碼可讀性、LLM應用安全)。支援 @標識 顯式呼叫跳過路由。

↓ 528.1萬★ 32user_814dbe54
dev-expert-pro開發程式設計

程式設計專家 Pro:融合程式設計專家 2.0.3 工程專題與程式設計大神的鴻蒙 ArkTS/ArkUI、微信小程式和小遊戲開發資料。用於專案實現、根因除錯、審查、重構、測試、架構效能分析及多端開發驗證。支援自然語言和 @專題標識,按任務讀取包內知識;只問概念時直接回答。

↓ 104.7萬★ -user_814dbe54
程式設計專家 Pro開發程式設計

程式設計專家 Pro:融合程式設計專家 2.0.3 工程專題與程式設計大神的鴻蒙 ArkTS/ArkUI、微信小程式和小遊戲開發資料。用於專案實現、根因除錯、審查、重構、測試、架構效能分析及多端開發驗證。支援自然語言和 @專題標識,按任務讀取包內知識;只問概念時直接回答。

↓ 98.2萬★ 1user_28275a78
程式設計專家.Skill開發程式設計

程式設計專家.Skill P8級程式設計助手,25年實戰經驗技能Skill,全棧:Java/Php網站/軟體專案、API設計、Bug診斷、程式碼生成、程式碼審查、重構、測試用例、效能基準、技術選型、文件生成、任務拆解、Spec驅動、Karpathy規範、CMS二次開發、前端設計、MySQL/Mariadb、專案知識圖譜,以及工程紀律層(根因除錯硬閉環、階段導航、事故復盤/SLO、威脅建模/供應鏈安全、生產就緒/漸進式釋出、AI編碼治理、面向Agent程式碼可讀性、LLM應用安全)。支援 @標識 顯式呼叫跳過路由。

↓ 70.1萬★ 6user_613b33ea
Github開發程式設計

用 gh 命令列工具檢視 GitHub 上的 PR 檢查、工作流執行與 API 查詢的技能。

↓ 48萬★ 714Peter Steinberger

Iván 的其他技能

資料月份:2026-10 · 下載/星標數聚合自公開技能註冊庫(ClawHub、SkillHub),按月更新。口徑說明見資料方法。