React 设计模式
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/shipshitdev-skills-react-patterns。
技能介绍
要解决什么问题
在 Next.js App Router、React 19 和 TypeScript 并存的项目里,常见痛点不是「会不会写组件」,而是选型犹豫:该用 Server 还是 Client、状态该留在 useState 还是上 Context / React Query、列表卡顿时该先虚拟化还是先 profile。SKILL.md 把这类决策压成可对照的表格与规则,而不是泛泛的「最佳实践」口号。
技能如何帮你落地
技能按十块组织内容,覆盖从结构到测试的完整链路:
- 组件分层:区分 Server / Client / Presentational / Container,并强调单一职责、组合优于继承。
- Hooks:说明何时抽
useDebounce、useFetch、useForm等,以及顶层调用、卸载清理等硬性规则。 - 状态管理:按复杂度对照
useState、Context、React Query / SWR、Zustand / Redux Toolkit,并给出「单组件 / 父子 / 子树 / 全站」的放置位置。 - React 19:
useActionState、useOptimistic、use与编译器自动 memo 带来的写法变化。 - 组合与性能:Compound Components、Render Props vs Hooks 的取舍,以及「先 profile 再优化」的顺序。
- 工程配套:Error Boundary 分层、Props 的 TypeScript 类型、测试层级,以及 Prop drilling、巨型组件等反模式对照表。
使用时,把当前任务映射到对应章节(例如表单提交 → React 19 + 状态;深嵌套传参 → 组合 / Context),按表格做选择,再写代码。
适用边界
本技能是模式与决策速查,不能替代你仓库里的 lint 规则、设计系统约束或线上性能实测。任务若缺少明确技术栈、路由形态或成功标准,应先澄清再套用;也不要把输出当作无须 review 的最终架构方案。
使用场景
- 新功能要在 App Router 里拆分 Server/Client 组件,需对照职责表避免整页都标 use client
- 复杂表单多处防抖与校验,需要判断是否抽成 useForm、useDebounce 而非复制逻辑
- 列表滚动卡顿,要先按技能里的优化顺序用 DevTools 定位再决定虚拟化或 useMemo
- 路由级功能要挂 Error Boundary,需按 app / feature / component 三层决定包裹范围
适合人员
- 维护 Next.js 单体前端的工程师,经常在 PR 里被问「这段状态为什么不放 React Query」
- 负责组件库或设计系统配套文档的前端,要写清 Presentational/Container 与 Compound 组件约定
- 从 Options API 或类组件迁到 Hooks + TS 的团队成员,需要反模式表避免 prop drilling 和巨型文件
- Introduce React 19 表单的试点开发者,要对齐 useActionState、useOptimistic 与乐观 UI 写法