用途:在用户打开或查看代码时,自动分析文件并识别常见代码坏味道与反模式,提供即时质量反馈,辅助而非替代人工代码评审。
主要能力:覆盖六类问题——复杂度(长方法、长参数列表、复杂条件、高圈复杂度、深层嵌套)、重复(重复代码、相似函数、魔法数字、重复字符串)、命名(含义不清、匈牙利命名、命名不一致、缩写、误导性命名)、面向对象(上帝类、数据类、依恋情结、不当亲密、懒惰类)、函数式(副作用、非纯函数、可变性问题、回调地狱)、架构(循环依赖、缺失抽象、紧耦合、抽象泄漏)。检测流程为解析文件、识别模式、计算指标、评估严重度、生成报告,使用 AST 解析、模式匹配、指标计算与上下文感知分析。
使用方式:作为技能在用户查看代码时自主触发,无需手动调用;返回结构化对象,含文件、语言、总体评分、坏味道列表(类型、严重度、位置、描述、建议、影响、修复成本)、指标(代码行数、平均与最大复杂度、重复率)和推荐列表。
适用场景:日常开发中快速发现明显质量问题,尤其适合评审前自查、遗留代码梳理和重构前评估。
限制:无法解析的文件返回语法错误详情;不支持的语言建议人工审查或通用分析;超过 1 万行会警告并建议拆分;测试文件采用更宽松标准;生成代码会跳过部分检查或建议改进生成器。该技能不阻断工作,仅提供信息与建议。