可扩展的 React 组合模式。适用于重构布尔属性泛滥的组件、构建灵活的组件库或设计可复用 API。触发于复合组件、Render Props、Context Provider 或组件架构相关任务。包含 React 19 API 变更。
反应组成模式
功能概述
反应组成模式是一项面向实际任务的技能，主要用于构建灵活、可维护反应组件的组合模式；使用复合组件、 升力状态和。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
使用与执行
执行完成后建议检查结果是否符合预期，并保留必要记录。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
结果检查与注意事项
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
React 组合模式
构建灵活、可维护的 React 组件所采用的组合模式。通过使用复合组件（compound components）、状态提升（lifting state）以及内部组件组合等方式，避免布尔型 prop 的泛滥。这些模式在代码库规模扩大时，能同时提升人类开发者与 AI agent 的协作效率和可维护性。
适用场景
在以下情况下，请参考本指南：
- 重构包含大量布尔型 prop 的组件
- 构建可复用的组件库
- 设计具备高扩展性的组件 API
- 评审组件架构设计
- 开发复合组件或 Context Provider
规则分类（按优先级排序）
| 优先级 | 类别 | 影响程度 | 前缀 |
|---|---|---|---|
| 1 | 组件架构 | HIGH | architecture- |
| 2 | 状态管理 | MEDIUM | state- |
| 3 | 实现模式 | MEDIUM | patterns- |
| 4 | React 19 APIs | MEDIUM | react19- |
快速查阅
1. 组件架构（HIGH）
architecture-avoid-boolean-props— 不要添加布尔型 prop 来定制行为；应使用组合方式替代architecture-compound-components— 使用共享 Context 构建复杂组件结构
2. 状态管理（MEDIUM）
state-decouple-implementation— Provider 是唯一知晓状态如何被管理的位置state-context-interface— 定义包含 state、actions 和 meta 的通用接口，以支持依赖注入state-lift-state— 将状态上提至 Provider 组件中，供兄弟组件访问
3. 实现模式（MEDIUM）
patterns-explicit-variants— 创建显式的变体组件，而非依赖布尔型 prop 控制模式patterns-children-over-render-props— 使用 children 实现组合，而非 renderX 类型的 prop
4. React 19 APIs（MEDIUM）
⚠️ 仅适用于 React 19+。 若使用 React 18 或更早版本，请跳过本节。
react19-no-forwardref— 不要使用forwardRef；改用use()替代useContext()
使用方法
请阅读各条规则对应的独立文件，获取详细说明与代码示例：
rules/architecture-avoid-boolean-props.md rules/state-context-interface.md
每条规则文件均包含以下内容：
- 该规则重要性的简要说明
- 错误用法示例及问题分析
- 正确用法示例及实现原理说明
- 补充上下文信息与参考资料
完整编译文档
如需查看所有规则展开后的完整指南，请参阅：AGENTS.md
相关专题
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查，覆盖本地环境、Docker及多平台用法，帮助Go开发者快速上手。
2026.10.22
0
15
PHP2Shell漏洞是什么，哪些PHP版本和运行环境会受到影响，服务器应该如何检测与修复？本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤，以及修复验证、临时缓解和应急响应方案。
2026.10.22
0
12
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134万人学习
共49课时 | 82.5万人学习
最新文章