用途:对代码库进行系统性、只读的质量审计,识别技术债、架构问题与代码质量问题,适用于需要全面排查遗留代码或评估代码健康度的场景。
主要能力:分阶段执行审计。先确定范围并用 Glob 列出相关文件、建立逐文件待办清单,在 .audit/audit-report-[timestamp].md 生成结构化 Markdown 报告;随后运行自动化分析,包括 TypeScript 编译器诊断、ESLint(若已配置),并用 Grep 搜索 TODO、FIXME、HACK、XXX、@deprecated 等模式;再逐文件检查废弃 API、未完成事项、架构反模式(上帝对象、循环依赖、紧耦合、违反 SOLID、模式不一致)、类型问题(any/unknown、缺失注解、错误类型、掩盖问题的类型转换)以及代码异味(重复代码、过长函数/类、复杂条件、死代码、魔法数字/字符串、命名不佳)。每个发现按 CRITICAL、HIGH、MEDIUM、LOW 分级,并进行跨文件模式与依赖分析,最后运行类型检查(如 tsc --noEmit)、Lint(如 npm run lint)和构建,输出执行摘要与 Top 10 关键发现。
使用方式:由用户提出审计请求后触发,技能按上述阶段推进,实时更新待办清单,发现新文件时动态加入。
限制:审计过程为只读,不修改文件;只识别并报告问题,不提供修复建议,也不制定行动计划。