React 组合模式

用于构建灵活、可维护的 React 组件的组合模式。通过使用复合组件、状态提升和内部组合，避免布尔属性泛滥。这些模式使得代码库在扩展时，无论是对于开发者还是AI智能体，都更易于协作。

何时应用

在以下情况下参考这些指南：

• 重构具有多个布尔属性的组件时
• 构建可复用的组件库时
• 设计灵活的组件API时
• 评审组件架构时
• 使用复合组件或上下文提供者时

按优先级划分的规则类别

快速参考

1. 组件架构（高优先级）

• 架构-避免布尔属性- 不要通过添加布尔属性来定制行为；应使用组合
• 架构-复合组件- 使用共享上下文来构建复杂组件

2. 状态管理（中等优先级）

• 状态-解耦实现- Provider 是唯一知道状态如何管理的地方
• 状态-上下文接口- 为依赖注入定义包含状态、操作和元数据的通用接口
• 状态-状态提升- 将状态移至 Provider 组件中，以便兄弟组件访问

3. 实现模式（中级）

• 显式变体模式- 创建显式的变体组件，而非使用布尔模式
• 子组件优于渲染属性模式- 使用子组件进行组合，而非使用renderX属性

4. React 19 API（中级）

⚠️ 仅适用于 React 19+。如果使用 React 18 或更早版本，请跳过此部分。

• React 19 中无需使用 forwardRef- 不要使用forwardRef；应使用use()替代useContext()

如何使用

请阅读各个规则文件以获取详细解释和代码示例：

rules/architecture-avoid-boolean-props.md
rules/state-context-interface.md

每个规则文件包含：

• 简要解释其重要性
• 错误代码示例及解释
• 正确代码示例及解释
• 补充背景与参考资料

完整汇编文档

完整指南（含所有规则详解）：AGENTS.md