React 组合模式
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,将「React Composition Patterns」技能(规范名 @org-eyw2ohcx/vercel-labs-agent-skills-composition-patterns)安装到你的 AI 助手中。
技能介绍
先解决什么问题
随着组件库扩张,最常见的坏味道是布尔属性不断膨胀:<Button primary disabled loading variant> 能组合出数十种状态,但类型系统和文档几乎无法穷举,调用方也记不住哪个布尔值控制什么。该技能面向正在维护 React 组件库、或准备重构复杂组件 API 的工程师,用组合替代布尔开关,让 API 更稳定、行为更可预期。
核心思路
技能按优先级组织规则,覆盖四类问题:
architecture-:组件架构。避免继续新增布尔属性来定制行为,改用组合;用 compound components 把共享状态收进上下文,而不是把状态散落到每个子组件里。state-:状态管理。Provider 是唯一知道状态如何实现的地方;通过state / actions / meta定义泛型接口用于依赖注入;需要兄弟节点共享状态时,把状态提升到 Provider 组件内部。patterns-:实现模式。用显式 variant 组件替代mode、type这类布尔模式;组合子组件优先使用children,而不是继续堆renderXxx属性。react19-:React 19 API。不要继续使用forwardRef;在合适场景优先使用use(),而不是useContext()。
每条规则文件给出简述、反例与正例代码、补充上下文和参考资料,便于接到代码评审流程里逐条落地。完整展开版见仓库中的 AGENTS.md。
适用边界
适合在重构布尔属性过多的组件、构建可复用组件库、设计灵活组件 API、评审组件架构或使用 compound components / context providers 时参考。react19- 类规则仅适用于 React 19+;如果项目还在 React 18 或更早版本,请跳过该部分。
使用场景
- 重构含多个布尔属性的展示组件,用复合组件替代属性开关
- 设计可复用组件库的对外 API,避免公开过多配置项
- 评审组件架构,评估状态是否应提升到 Provider 中
- 升级到 React 19 时替换 `forwardRef` 相关写法
适合人员
- 承担团队通用组件库建设,需要长期维护 API 的前端架构师
- 维护中型 React 应用,常遇到布尔属性泛滥的工程师
- 希望 AI agent 更准确理解组件接口的技术负责人
- 正在推进 React 19 升级并清理过时模式的前端团队