用途:对代码库做全面架构审计,聚焦结构性问题和系统性问题,而非单点 bug。
主要能力:分阶段执行。先梳理目录结构、识别入口点、建立文件清单;随后检测死代码(未被导入的导出、未被调用的函数、未使用的类型与常量);检测重复功能(完全重复、相似逻辑、概念重复、类型重复);识别架构反模式(上帝对象、循环依赖、紧耦合、分层违规、单例滥用、贫血领域模型等);分析类型问题(any、unknown、类型断言、@ts-ignore);以及代码坏味道(超长函数、复杂条件、魔法数字、注释掉的代码、命名问题)。
使用方式:以仓库为输入,按阶段逐文件分析,使用 find、grep、Glob 等命令检索引用与模式,逐项记录发现并标注置信度(HIGH/MEDIUM/LOW)。最终在 .audits/architectural-analysis-[timestamp].md 生成结构化报告,并给用户一段简要总结。示例命令:find . -type d -not -path "/node_modules/" -not -path "/.git/";grep -r ": any" . --include=".ts" --include=".tsx" -n。
适用场景:代码重构前评估、技术债盘点、接手遗留项目、合并重复实现、清理无用文件。
限制:仅做分析,明确不修改文件;需全量分析,不跳过文件;需人工复核误报(测试、动态导入、反射、公开 API、框架钩子等可能被误判为死代码)。具体支持语言以实际项目文件类型为准,资料未提供更细的安装或运行方式。