用途:对代码库执行全面的架构审计,聚焦结构性问题和系统性问题,包括死代码、重复实现、架构反模式、类型问题与代码异味。该技能只做分析,不编辑任何文件。
主要能力:分阶段执行审计。先映射目录结构、统计文件类型、识别入口点并建立待分析文件清单;随后逐文件检测死代码(未被导入的导出、未被调用的函数、未被引用的类型与常量),并区分完全死代码、可能死代码与内部死代码,同时排查测试、动态导入、反射、公共 API、框架钩子等误报情形。接着检测重复:精确重复、相似逻辑、概念重复与类型重复,并给出保留与合并建议。还会识别上帝对象、循环依赖、紧耦合、分层违规、单例滥用、贫血模型、霰弹式修改、依恋情结等反模式;分析 any、unknown、类型断言、@ts-ignore 等类型问题;检测长函数、长参数列表、复杂条件、魔法数字、注释掉的代码与命名问题。
使用方式:技能以指令流程驱动,配合 find、grep、wc 等命令扫描代码库,例如 find . -type d -not -path "/node_modules/" -not -path "/.git/"、grep -r "import.ExportName" . --include=".ts"、find . -name "*.ts" -exec wc -l {} + | sort -rn | head -20。最终在 .audits/architectural-analysis-[timestamp].md 生成报告,包含执行摘要、死代码清单、重复分组、反模式、类型问题、代码异味、统计与影响评估,并向用户输出简要总结。
适用场景:TypeScript/JavaScript 项目的架构健康检查、重构前评估、技术债盘点与代码清理规划。
限制:仅支持分析,不执行清理;部分结论需人工验证,存在误报可能;具体支持的语言范围、安装方式与收费信息暂未提供。