用途:面向 React 的组件组合模式规则集,帮助构建灵活、可维护的组件,避免通过添加布尔属性来定制行为。适用于重构布尔属性繁多的组件、构建可复用组件库、设计灵活的组件 API、审查组件架构,以及使用复合组件或 Context Provider 的场景。
主要能力:规则按优先级分为四类。架构类(HIGH)包含避免布尔属性、使用共享上下文构建复合组件;状态管理类(MEDIUM)包含让 Provider 成为唯一知晓状态管理方式的位置、定义含 state/actions/meta 的通用接口以便依赖注入、将状态上提到 Provider 组件供兄弟组件访问;实现模式类(MEDIUM)包含用显式变体组件替代布尔模式、用 children 组合替代 renderX 属性;React 19 API 类(MEDIUM)包含不使用 forwardRef、用 use() 替代 useContext(),仅适用于 React 19 及以上。
使用方式:按需阅读各规则文件获取详细说明与代码示例,如 rules/architecture-avoid-boolean-props.md、rules/state-context-interface.md。每个规则文件包含原因说明、错误示例与解释、正确示例与解释及补充参考。完整指南见 AGENTS.md。
限制:React 19 API 部分仅适用于 React 19 及以上版本,React 18 或更早版本应跳过该部分。其余限制资料未提供。