本技能适用于编写 React 组件(服务端或客户端)、使用标准及 React 19 新增 Hooks、以 Server Actions 实现表单、使用 Suspense 与流式渲染、管理状态与过渡、做乐观 UI 更新,以及从 React 18 迁移到 React 19 的场景。
主要能力:服务端与客户端组件完整决策树;全部 React Hooks 参考(含 TypeScript);Suspense 边界、流式与错误处理;服务端组件的数据获取、缓存与组合;客户端组件的交互、状态与副作用;useTransition、startTransition、isPending 过渡;渐进式渲染;以及 React 18→19 迁移指南。React 19 新特性覆盖 use()、useOptimistic()、useFormStatus()、useActionState()、增强的 useTransition()、改进的错误边界与水合。
组织方式:技能拆分为 server-vs-client.md、hooks-complete.md、suspense-patterns.md、server-components-complete.md、client-components-complete.md、transitions.md、streaming-patterns.md、migration-guide.md 等文档,并附带 validate-react.py 校验工具。
使用方式:按决策流判断组件类型——需要交互或 Hooks 读客户端组件文档,需要取数读服务端组件文档。校验工具用法: python .claude/skills/react-19-patterns/validate-react.py src/components/Button.tsx python .claude/skills/react-19-patterns/validate-react.py src/components/ python .claude/skills/react-19-patterns/validate-react.py --fix src/components/ 可检查 Hooks 规则违规、服务端/客户端组件错误、缺失 'use client'、非法异步客户端组件、服务端组件中使用浏览器 API、向客户端组件传不可序列化 props。
最佳实践:默认使用服务端组件,仅在需要交互时使用客户端组件并保持其精简,在服务端取数后以 props 传给客户端组件,使用 React 19 新 Hooks 并借助 Suspense 渐进流式加载。
限制:资料未提供收费、价格、适用平台或效果相关说明;示例针对 React 19.2.0 与 Next.js 15.5,其他版本兼容性暂未提供。