SuperAPI AI 工具集

god-component-detector

编程与开发

查看项目

更新于 10-16 10:20

技能介绍

用途

God Component Detector 用于识别 React/Next.js 中的“上帝组件”。这类组件也被称为“上帝对象”或“Blob 反模式”,其特点是知道得太多、做太多事、体积过大,并把多个不相关的职责混在一起(通常是 UI 渲染 + 业务逻辑 + 数据获取 + 副作用)。该技能面向代码审查、架构评估和可维护性检查场景。

主要能力

检测围绕代码规模、Hook 使用、职责混合、依赖、函数数量和 JSX 复杂度展开。

关键红旗(高严重度):

  • 文件大小:超过 500 行视为严重违规;300–500 行需要关注;低于 300 行可接受。
  • 单组件内混合关注点:UI + 业务逻辑 + 数据获取 + 副作用;复杂状态管理 + API 调用 + 校验 + 格式化。UI + 简单业务逻辑在局部化时可容忍。
  • 状态管理过多:超过 8 个 useState、超过 5 个 useEffect,或存在多个不相关的状态变量。

警告信号(中高严重度):

  • 多重职责:数据获取、表单校验、业务计算、UI 渲染、事件处理、路由逻辑、错误处理、鉴权检查等。超过 4 种不同职责类型即判定为上帝组件。
  • 依赖过多:来自不同模块的 10 个导入、5 个自定义 Hook、传给组件的 8 个 props。
  • 复杂嵌套逻辑:嵌套超过 4 层、多个三元表达式、大量条件渲染。

代码异味(中严重度):

  • 函数激增:10 个内部函数/处理器、单个函数超过 50 行、函数做多件事。
  • 直接 API 调用:组件内直接使用 fetch/axios 或数据库查询,本应放在 Hook/服务中。
  • 复杂计算:渲染中执行业务计算、JSX 中做数据转换,本应抽到工具函数/Hook。
  • 副作用混杂:多个不相关的 useEffect、依赖繁多的 effect、一个 effect 做多件事。

检测流程

分析组件文件时:

  1. 基础指标:代码行数(LOC = 总行数 − 注释 − 空行)。LOC > 500 为 CRITICAL,LOC > 300 为 WARNING。
  2. 统计 Hook 使用:useState 超过 8 个标记;useEffect 超过 5 个标记;自定义 Hook 超过 5 个标记。
  3. 识别职责:查找数据获取(fetch、axios、useSWR、useQuery、API 导入)、表单处理(表单状态、校验、提交逻辑)、业务逻辑(计算、转换、复杂条件)、副作用(useEffect、订阅、定时器、监听器)、路由(useRouter、useNavigate、router.push)、状态管理(复杂状态更新、reducer)、鉴权/授权(鉴权检查、权限逻辑)、UI 渲染(JSX、样式、布局)。超过 4 种不同职责类型即判定为上帝组件。
  4. 函数分析:统计内部函数(处理器、工具函数),超过 10 个为 WARNING;任一函数超过 50 行为 FLAG。
  5. JSX 复杂度:统计条件渲染(?:、&&),超过 8 个为 WARNING;检查嵌套深度,超过 4 层为 WARNING。

输出格式

对每个检测到的上帝组件,输出:文件:行号、严重级别(CRITICAL / HIGH / MEDIUM)、LOC、问题列表、发现的职责及证据、指标(useState、useEffect、函数、props、导入数量),以及重构建议。

重构策略

该技能给出多种重构示例:

  1. 抽离自定义 Hook:把组件内的数据获取与加载状态迁移到 useData 之类的 Hook,组件只保留 UI。
  2. 把业务逻辑抽到服务层:例如将投资组合盈亏计算抽到 PortfolioCalculator 类。
  3. 拆分为更小的组件:把 Dashboard 拆成 DashboardHeader、DashboardSidebar、DashboardContent、DashboardFooter 等单一职责组件。
  4. 用组合替代配置:将 props 繁多的 DataTable 拆为 DataTable、DataTableHeader、DataTableBody 等可组合组件。
  5. 抽取 Server Actions(Next.js):把客户端组件中的 API 逻辑迁移到 "use server" 的 server action。

常见上帝组件模式

  • “全能表单”:表单状态 + 校验 + 提交 + 错误处理 + 成功处理 + 路由。修复方式:表单逻辑抽到自定义 Hook,校验抽到 schema,API 抽到 server action。
  • “仪表盘大杂烩”:多个数据源 + 计算 + 图表 + 表格 + 筛选 + 导出。修复方式:拆分为专注组件,数据获取抽到 Hook。
  • “弹窗管理器”:多个弹窗状态 + 内容 + 逻辑 + 父组件逻辑。修复方式:弹窗逻辑抽到 context 或状态管理,弹窗组件分离。
  • “列表 + 全套 CRUD”:列表渲染 + 增删改查 + 排序 + 筛选 + 分页。修复方式:分离列表展示与 CRUD 操作,抽取 Hook。
  • “页面组件”:整页放在一个组件里,含布局 + 头部 + 侧边栏 + 内容 + 底部。修复方式:拆为布局组件,使用组合。

使用方式

当被要求检测上帝组件时:针对单个文件则分析该文件;针对模式/目录则查找匹配的所有组件;无参数时询问用户要分析哪些文件或模式。对每个文件计算所有指标、识别职责、判定严重级别、生成重构建议,并按指定格式输出。

常见触发语句包括:“检查这个组件是否有上帝组件反模式”“这个组件是不是太大了?”“审查这个文件的架构问题”“找出 /components 下所有上帝组件”“为这个组件建议重构”。

集成与参考

可与其他技能配合:vercel-react-best-practices(重构后的性能优化)、web-design-guidelines(拆分组件的 UI 最佳实践)、标准代码审查(架构与可维护性)。参考来源包括《Clean Code》(单一职责原则)、《Refactoring》、组件驱动开发模式和 React 组件组合模式。

限制

资料未提供该技能的安装命令、运行环境要求、支持的文件扩展名或框架版本范围,暂未提供相关信息。