SuperAPI AI 工具集

architectural-analysis

通用与其它

查看项目

更新于 10-15 20:30

技能介绍

用途:对代码库执行全面的架构审计,聚焦结构性问题、死代码、重复实现与系统性缺陷,最终产出审计报告。

主要能力:分阶段进行。先梳理目录结构与入口点,建立待分析文件清单;随后检测死代码(未被导入的导出、未被调用的函数、未使用的类型与常量),并区分“确定死代码”“可能死代码”和“内部死代码”,同时排查测试、动态导入、反射、公共 API、框架钩子等误报情形。接着检测重复:精确重复、相似逻辑、概念重复与类型重复,并给出保留与合并建议。还会识别架构反模式,如上帝对象、循环依赖、紧耦合、分层违规、单例滥用、贫血模型、霰弹式修改、依恋情结等。类型分析部分查找 any、unknown、类型断言、@ts-ignore/@ts-expect-error 及类型重复与缺失。代码坏味道部分检查过长函数、过长参数列表、复杂条件、魔法数字/字符串、注释掉的代码与命名问题。

使用方式:按阶段执行,使用 find、grep、wc 等命令辅助扫描,例如 find . -type d -not -path "/node_modules/" -not -path "/.git/"、grep -r ": any" . --include=".ts" --include=".tsx" -n、find . -name "*.ts" -exec wc -l {} + | sort -rn | head -20。最后用 todos_oneshot(title: "Audit: Architectural analysis", description: "<report content>", tags: "audit", type: "task") 创建带 audit 标签的工单,报告包含执行摘要、死代码、重复功能、架构反模式、类型问题、代码坏味道、统计与影响评估。

适用场景:TypeScript/JavaScript 项目重构前评估、技术债盘点、代码清理与维护性改进。

限制:资料未提供具体支持的框架、语言范围、运行环境、收费方式或效果保证;部分检测依赖人工阅读与判断,存在误报可能,需人工复核。