用途:本技能提供一套可扩展的 React 组合模式规则,帮助在重构布尔属性泛滥的组件、构建可复用组件库、设计灵活的组件 API 以及审查组件架构时参考,使代码库更易被人和 AI 智能体维护。
主要能力:按优先级分为四类规则。组件架构(HIGH):避免用布尔属性定制行为,改用组合;用共享 context 组织复杂复合组件。状态管理(MEDIUM):Provider 是唯一了解状态如何管理的地方;定义包含 state、actions、meta 的通用接口用于依赖注入;将状态提升到 provider 组件供兄弟组件访问。实现模式(MEDIUM):创建显式变体组件代替布尔模式;使用 children 组合代替 renderX 属性。React 19 API(MEDIUM,仅限 React 19 及以上,使用 React 18 或更早版本请跳过):不使用 forwardRef,用 use() 代替 useContext()。
使用方式:阅读各规则文件获取详细说明与代码示例,例如 rules/architecture-avoid-boolean-props.md、rules/state-context-interface.md;每个规则文件包含重要性简述、错误代码示例与解释、正确代码示例与解释,以及额外上下文和参考。完整指南见 AGENTS.md。
适用场景:组件重构、组件库建设、组件 API 设计、架构评审,以及与复合组件或 context provider 相关的工作。
限制:React 19 APIs 部分仅适用于 React 19 及以上;其他具体安装方式、收费、价格、平台与效果等资料暂未提供。