用途:这是一套 React 组合模式(Composition Patterns)指南,用于构建灵活、可维护的 React 组件。当组件出现大量布尔属性、需要构建可复用组件库、设计灵活的组件 API、审查组件架构,或使用复合组件与 Context Provider 时,可参考这些规则。
主要能力:规则按优先级分为三类。组件架构(HIGH):architecture-avoid-boolean-props 建议不要通过新增布尔属性定制行为,而应使用组合;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 属性。
使用方式:按需阅读各规则文件,例如 rules/architecture-avoid-boolean-props.md、rules/state-context-interface.md。每个规则文件包含:为何重要的简要说明、带解释的错误代码示例、带解释的正确代码示例,以及额外上下文与参考。完整指南见 AGENTS.md。
适用场景:重构布尔属性过多的组件、构建可复用组件库、设计组件 API、审查组件架构、使用复合组件或 context provider。
限制:资料未提供具体安装命令、依赖版本、平台支持范围、收费方式或效果数据,暂未提供。