SuperAPI AI 工具集

react-code-smells

前端与建站

查看项目

更新于 10-16 03:46

技能介绍

用途:这是一份 React 应用的资深工程师级重构指南,用于识别并消除代码异味,适合重构既有 React 代码库、审查 PR 中的架构问题、识别技术债、规划大规模重构、判断组件该抽取还是内联,以及提升代码可测性。

主要能力:包含 42 条规则,分布在 8 个按影响优先级排序的类别中,每条规则提供代码异味信号、before/after 示例与安全的改造步骤。分类及优先级前缀如下:1 状态架构(CRITICAL,state-);2 组件组合(CRITICAL,comp-);3 抽象质量(HIGH,abs-);4 耦合与内聚(HIGH,couple-);5 Hook 规范(MEDIUM-HIGH,hook-);6 渲染模式(MEDIUM,render-);7 副作用管理(MEDIUM,effect-);8 可测性(LOW-MEDIUM,test-)。

典型规则示例:以复合组件或组件组合替代 prop drilling、用派生计算替代同步状态、用状态机替代布尔爆炸、状态共置、用 useReducer 合并相关 useState、用 context selector 防止级联重渲染、将可分享状态放入 URL。组件层面包括抽取 render props 或 Hook 共享逻辑、用 slots/children 替代配置型 props、拆分上帝组件、审慎选择受控与非受控、抽取 headless 组件、避免无类型 props 展开、使用多态 as prop、校验复合组件 children。此外还涵盖警惕过早抽象(三次法则)、优先组合而非配置、抽取自定义 Hook、判断内联与抽取、先内联修复错误抽象、区分工具 Hook 与领域 Hook;按特性共置文件、依赖注入、props 接口隔离、反向依赖破解循环、只从稳定公共 API 导入;Hook 依赖稳定性、组合小 Hook、返回对象还是元组、禁止条件调用、命名约定;早返回条件渲染、列表 key 稳定性、避免 JSX 内联对象、用 Fragment 避免包裹 div;把事件响应从 effect 移到 handler、始终清理副作用、拆分无关 effect、移除非同步用途的 effect;为可测性创建接缝、测试行为而非实现细节、抽取逻辑到 Hook、在边界而非内部细节处 mock。

使用方式:阅读各条参考文件获取详细说明与代码示例,另提供分类定义与新增规则模板;相关技能包括 react、react-principle-engineer、react-hook-form。

限制:资料未提供该技能的安装命令、收费方式、支持的 React 版本门槛或运行平台等具体信息。