用途:对代码做只读的可维护性审计,在问题累积前发现并报告。它不修改任何代码,只读取、搜索并生成报告。
主要能力:识别 DRY 违规(重复函数、复制粘贴逻辑、冗余类型定义、重复校验模式);YAGNI 违规(过度抽象、无人使用的配置项、过早泛化);KISS 违规(不必要的间接层、职责混杂、过深嵌套);死代码(未使用函数、未引用导入、孤立导出、注释掉的代码、不可达分支);一致性问题(错误处理与 API 风格不统一、命名违规);概念与契约漂移、边界泄漏、迁移债务、耦合问题(循环依赖、上帝对象、特性依恋)、内聚问题、可测试性障碍、时序耦合、常见反模式,以及 eslint-disable、@ts-ignore、# type: ignore 等抑制注释的滥用。
使用方式:优先审查用户指定的文件或目录;未指定时对比 origin/main 或 origin/master,例如 git diff origin/main...HEAD && git diff。范围不明确或无变更时会先向用户确认。审查时先读完整文件再结合 diff 分析,并做跨文件检查。默认只报告本次变更引入或明显加重的问题;显式指定路径时则审查该范围内全部问题。
适用场景:提交 PR 前的代码审查、对指定目录做可维护性体检。
限制:不报告类型安全、文档准确性、功能缺陷、测试覆盖缺口等问题,这些由其他技能处理;跳过生成文件、锁文件和第三方依赖;不报告范围外的既有技术债;不虚构问题,无问题也是有效结论。输出为按严重级别分类的报告,含位置、证据、影响、修复成本与建议。