SuperAPI AI 工具集

inspect-code

编程与开发

查看项目

更新于 11-05 16:17

技能介绍

用途

inspect-code 用于在重构前对源码模块做只读的结构性审查,定位结构性技术债和可维护性风险,而不是做语法格式检查或业务规则评估。

主要能力

  • 类内聚与单一职责:识别聚合多个不相关领域关注点、字段/方法过多或方法内聚度低的 God Class。
  • 方法与流程复杂度:识别过长方法、控制流嵌套≥3 层、箭头反模式和高认知负载。
  • 系统性重复:识别跨类、跨文件、跨方法的复制粘贴算法、校验序列或错误处理管线。
  • 耦合与封装泄漏:识别 Feature Envy、直接暴露可变内部集合的 getter 等。
  • 多态与策略缺失:识别散落在多个类中的并行 switch/if 类型分支。
  • 健壮性与资源卫生:识别空 catch 吞异常、未管理流/连接/监听器缺少清理钩子等。

使用方式

提供目标路径(文件、目录或子系统)。小于 10 个文件或单一内聚模块时直接在当前轮次审查;多包子系统或较大仓库时,可分派 2–3 个结构审查子代理并行检查不同切片,再汇总去重。输出遵循固定审查报告契约,包含执行摘要(目标、健康评级 CLEAN/MODERATE_DEBT/CRITICAL_DEBT、主要瓶颈)、技术债清单(严重级别、维度、实体、位置、问题、改进建议)和流程路由建议(/changeset 用于多文件结构重构,/diagnose 用于运行时功能缺陷)。

适用场景

适用于重构前评估、代码评审中的结构问题排查、技术债盘点,以及需要把结构治理与格式检查、业务逻辑诊断分开处理的团队流程。

限制

该技能只读,不修改磁盘文件、不生成代码 diff、不自动应用重构;不检查空白与分号等格式细节;不评估业务规则、定价逻辑或数学公式;缺少权威规格时不判断业务正确性。