Agent Skills
返回列表
💻

React 设计模式

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 写法