用途:为构建灵活、易维护的 React 组件提供组合(composition)模式指南。适用于重构含大量布尔属性的组件、构建可复用组件库、设计灵活的组件 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 属性)。React 19 API(MEDIUM)包含 react19-no-forwardref(不使用 forwardRef,用 use() 代替 useContext()),仅限 React 19+,React 18 及更早版本请跳过该节。
使用方式:阅读各规则文件获取详细说明与代码示例,如 rules/architecture-avoid-boolean-props.md、rules/state-context-interface.md。每个规则文件包含重要性简述、错误代码示例及说明、正确代码示例及说明,以及补充上下文与参考。完整合并文档见 AGENTS.md。
限制:react19 相关规则仅适用于 React 19 及以上版本;资料未提供安装命令、收费方式、平台支持等具体细节。