React Expert 是一个用于构建 React 18+ 应用的专业技能,定位为精通 React 19、Server Components 与生产级应用架构的资深 React 专家。资料显示,该技能由 paperclipai/companies 收录,其正文引用并声明遵循上游文档 jeffallan/claude-skills 中 react-expert 技能(仓库 revisions 已标注),许可为 MIT,作者署名 Jeffallan。
适用场景
根据资料中的「何时使用此技能」,它适用于:构建新的 React 组件或功能;实现状态管理(本地状态、Context、Redux、Zustand);优化 React 性能;搭建 React 项目架构;使用 React 19 Server Components;使用 React 19 actions 实现表单;以及使用 TanStack Query 或 use() 进行数据获取。
核心工作流
资料给出的工作流步骤为:1)分析需求,确定组件层级、状态需求与数据流;2)选择模式,选定合适的状态管理与数据获取方式;3)实现,编写带正确类型的 TypeScript 组件;4)校验,运行 tsc --noEmit,若失败则查看报告的錯誤、修复所有类型问题并重新运行,直至通过后再继续;5)优化,在需要处应用记忆化并确保可访问性,若引入新的类型错误则返回第 4 步;6)测试,使用 React Testing Library 编写测试,若断言失败则调试修复后再提交。
参考文档
技能按上下文加载详细指引,资料列出的主题与对应参考文件包括:Server Components(references/server-components.md,用于 RSC 模式、Next.js App Router)、React 19(references/react-19-features.md,用于 use() hook、useActionState、表单)、状态管理(references/state-management.md,用于 Context、Zustand、Redux、TanStack)、Hooks(references/hooks-patterns.md,用于自定义 hooks、useEffect、useCallback)、性能(references/performance.md,用于 memo、lazy、虚拟化)、测试(references/testing-react.md,用于 Testing Library、mock)、类组件迁移(references/migration-class-to-modern.md,用于将类组件转换为 hooks/RSC)。
关键模式
资料给出了三个关键代码示例。其一为 Next.js App Router 的 Server Component:app/users/page.tsx 中不使用 "use client",通过 db.user.findMany() 获取 users 并以 ul/li 渲染,key 使用 user.id。其二为 React 19 表单:在 'use client' 下使用 useActionState,submitForm 为 async 函数接收 prev 与 formData 并返回字符串,组件内以 const [message, action, isPending] = useActionState(submitForm, '') 解构,form 的 action 绑定 action,提交按钮根据 isPending 禁用并显示 Submitting…。其三为带清理的自定义 Hook useWindowWidth:用 useState(() => window.innerWidth) 初始化,useEffect 中注册 resize 监听并在返回的清理函数中移除监听。
约束
MUST DO(必须做):使用 TypeScript 严格模式;实现错误边界以实现优雅失败;正确使用 key prop(稳定、唯一标识);清理副作用(返回清理函数);使用语义化 HTML 与 ARIA 保证可访问性;在向被记忆化的子组件传递回调或对象时进行记忆化;对异步操作使用 Suspense 边界。MUST NOT DO(禁止做):直接修改 state;对动态列表使用数组下标作为 key;在 JSX 内创建函数(会导致重渲染);忘记 useEffect 清理(造成内存泄漏);忽略 React 严格模式警告;在生产环境跳过错误边界。
输出与知识范围
资料指出,在实现 React 功能时应提供:1)带 TypeScript 类型的组件文件;2)对非平凡逻辑提供测试文件;3)对关键决策的简要说明。其知识参考范围包括 React 19、Server Components、use() hook、Suspense、TypeScript、TanStack Query、Zustand、Redux Toolkit、React Router、React Testing Library、Vitest/Jest、Next.js App Router 与可访问性(WCAG)。
限制
资料未提供该技能的收费、价格、安装命令、具体平台支持范围等信息,暂未提供。
引用文档
以下为作者声明的引用来源,保留指定版本、署名和许可。
- jeffallan/claude-skills/skills/react-expert/SKILL.md — 署名:Jeffallan;许可:MIT;版本:
3bf9a24b76a7c122f1fc05e83929fbc84e1c207a。