用途:对代码库执行全面的架构审计,聚焦结构性问题、死代码、重复实现和系统性缺陷,最终在 .audits/architectural-analysis-[timestamp].md 生成报告。
主要能力:分阶段进行。先梳理目录结构与入口点,建立逐文件待办清单;再检测死代码(未被导入的导出、未调用的函数、未使用的类型与常量),并区分完全死代码、可能死代码与内部死代码,同时排查测试、动态导入、反射、公共 API、框架钩子等误报;随后检测重复功能,分为完全重复、相似逻辑、概念重复与类型重复;接着识别架构反模式,如上帝对象、循环依赖、紧耦合、分层违规、单例滥用、贫血模型等;还分析类型问题(any、unknown、类型断言、@ts-ignore、类型重复、缺失类型)与代码异味(长函数、长参数列表、复杂条件、魔法数字、注释掉的代码、命名不佳)。
使用方式:按技能说明逐步执行,使用 find、grep、wc 等命令辅助扫描,例如 find . -type d -not -path "/node_modules/" -not -path "/.git/"、grep -r ": any" . --include="*.ts" -n。每个文件分析后更新待办清单,最后汇总统计并输出报告。
适用场景:TypeScript/JavaScript 项目重构前评估、技术债盘点、代码审查准备、遗留系统清理规划。
限制:该技能明确要求 NEVER EDIT FILES,只做分析不做清理;需逐文件分析整个代码库,不可跳过;死代码判定需人工核实误报;报告中的行数、百分比等为估算值。具体平台支持与安装方式暂未提供。