SuperAPI AI 工具集

composition-patterns

编程与开发

查看项目

更新于 10-16 08:11

技能介绍

用途:在处理 React 组件组合模式相关任务或工作流时参考,尤其适用于重构含大量布尔 prop 的组件、构建可复用组件库、设计灵活的组件 API、评审组件架构,以及使用复合组件或 context provider 的场景。

主要能力:按优先级给出四类规则。一、组件架构(HIGH):architecture-avoid-boolean-props 建议不要靠新增布尔 prop 定制行为,改用组合;architecture-compound-components 建议用共享 context 组织复杂组件。二、状态管理(MEDIUM):state-decouple-implementation 让 Provider 成为唯一知道状态如何管理的地方;state-context-interface 定义含 state、actions、meta 的通用接口做依赖注入;state-lift-state 将状态移入 Provider 供兄弟组件访问。三、实现模式(MEDIUM):patterns-explicit-variants 用显式变体组件替代布尔模式;patterns-children-over-render-props 用 children 组合替代 renderX prop。四、React 19 API(MEDIUM,仅限 React 19+,React 18 及更早请跳过):react19-no-forwardref,不使用 forwardRef,用 use() 替代 useContext()。

使用方式:按需阅读单条规则文件获取详细说明与代码示例,例如 rules/architecture-avoid-boolean-props.md、rules/state-context-interface.md;每个规则文件含原因简述、错误代码示例及说明、正确代码示例及说明、补充上下文与参考。完整合并指南见 AGENTS.md。

限制:仅当任务明确符合上述范围时使用;输出不能替代针对具体环境的验证、测试或专家评审;若缺少必要输入、权限、安全边界或成功标准,应停止并请求澄清。