SuperAPI AI 工具集

architectural-analysis

通用与其它

查看项目

更新于 10-16 03:17

技能介绍

用途:对 TypeScript/JavaScript 代码库执行系统性的架构审计,定位结构性问题和系统级隐患,输出可读的审计报告,帮助团队评估清理与重构空间。

主要能力:

  • 死代码检测:逐文件识别未被导入的导出、未被调用的函数、未使用的类型与常量,并按 DEAD、POSSIBLY_DEAD、USED 分类,标注置信度。
  • 重复实现检测:按精确重复、相似逻辑、概念重复、类型重复分组,比较同一概念的多处实现并给出保留建议。
  • 架构反模式识别:查找上帝对象、循环依赖、紧耦合、分层违规,以及单例滥用、贫血模型、霰弹式修改、依恋情结等模式。
  • 类型问题分析:检索 any、unknown、as any、as unknown、@ts-ignore、@ts-expect-error 的用法,评估类型断言是否掩盖了真实问题。
  • 代码异味检测:超长函数、过长参数列表、复杂条件、魔法数字与字符串、被注释掉的代码、命名不佳等。

使用方式:按阶段推进。先用 find 与 Glob 梳理目录结构、统计文件类型、识别入口点,并建立逐文件的待办清单;随后对每个文件执行导出识别与引用搜索,例如 grep -r "import.ExportName" . --include=".ts" --include=".tsx"、grep -r "ExportName" . --include=".ts"、find . -name "*.ts" -exec wc -l {} + | sort -rn | head -20;再依次完成重复检测、反模式识别、类型分析与异味检测,最后生成报告。

报告位置与结构:在 .audits/architectural-analysis-[timestamp].md 生成报告,包含执行摘要、死代码清单、重复功能分组、架构反模式、类型问题、代码异味、统计与影响评估等部分。

适用场景:代码库接手前的体检、重构前的现状摸底、技术债盘点、架构评审准备。

限制:该技能为纯分析流程,明确要求不编辑任何文件,也不应跳过文件;自动化搜索可能产生误报,需人工核实测试用途、动态导入、反射或字符串引用、公共 API、框架钩子等例外情况。资料未提供语言外的具体环境要求、性能开销或报告之外的集成方式。