SuperAPI AI 工具集

llm-artifacts-detection

编程与开发

查看项目

更新于 10-15 21:39

技能介绍

用途:检测并标记 LLM 编码代理引入的、降低代码质量的常见模式,适合审查 AI 生成代码、生成后代码审查、清理 AI 编码代理所写代码以及识别降低可维护性的模式。

主要能力分为四类:测试方面检查 DRY 违规(重复的 setup/teardown、对象创建、mock 配置)、测试库/框架行为而非应用代码、mock 边界过深或过浅;死代码方面查找未被调用的函数、未被实例化的类、未读取的模块级变量、return 后不可达代码,以及 TODO/FIXME/HACK/XXX 注释、向后兼容残留(如 _unused、_old、_deprecated 后缀、仅用于兼容的重新导出、"# legacy" 类注释)和孤立测试;抽象方面识别仅委托单一方法的包装类、只有一种实现的接口/协议、单一具体类的抽象基类、总返回同类型的工厂函数,以及应参数化的 3 个以上相似代码块和从未切换的特性开关等过度配置;风格方面标记重复代码含义的注释、对平凡代码的过度文档、无必要防御性编程(对不可能失败代码的 try/except、非空值判空、已有类型提示仍做类型检查)和无价值类型提示。

使用方式:审查 AI 生成代码时加载本技能。若代理支持子代理,按每类检测并行分派一个;否则自行顺序处理各类别并产出同样的发现。使用 references/tests-criteria.md、references/dead-code-criteria.md、references/abstraction-criteria.md、references/style-criteria.md 获取详细标准与示例。每个问题按 [FILE:LINE] ISSUE_TITLE 格式报告。

报告门禁须按顺序执行,确保发现基于证据而非推断:Anchor 要求 FILE 和 LINE 来自本轮打开缓冲区或 read_file 的读取结果,不能仅依赖陈旧搜索片段;Title 要用平实语言描述缺陷而非提出修复;Dedup 在最终输出前合并同一 FILE:LINE 且同一根因的行。

限制:资料未提供安装命令、收费、价格、平台或效果信息,暂未提供。