SuperAPI AI 工具集

find-duplication

通用与其它

查看项目

更新于 10-16 03:11

技能介绍

用途:检测代码库中的重复或近似重复代码,提示可合并、参数化的候选位置。规则是只报告、不重构,重构属于单独任务;聚焦生产代码(ols/),除用户明确要求外跳过测试代码重复;按严重程度分组,先精确重复再近似重复;每条结果说明是否值得抽取,或属于可接受的重复。

使用方式分四步。第一步确定范围,询问用户选择分支模式(仅当前分支相对 main 改动的文件)或全量模式(扫描整个 ols/ 目录)。分支模式命令:git diff --name-only origin/main -- 'ols/' | grep '.py$';全量模式目标为 ols/。第二步运行 Pylint 重复检测:uv run pylint --disable=all --enable=duplicate-code --min-similarity-lines=6 <目标文件或目录>,并过滤误报,如导入块、Pydantic 模型样板(Field 声明)、单行模式(日志、raise)。第三步做语义重复搜索,因为 Pylint 只能发现文本相似,还需查找相似函数签名、重复的 try/except/log/return 错误处理模式、跨文件复制粘贴的代码块,可用 rg "<distinctive pattern>" ols/ --type py -l。第四步分类:完全相同逻辑出现在 3 处以上建议抽取共享辅助函数;结构相同仅值不同建议参数化;属于不同领域但相似的可接受、无需处理;仅测试中的重复设置或 fixture 在用户要求时才建议共享 fixture。最后输出报告,包含涉及文件与行范围、重复内容简述、分类、共享代码建议位置,以及发现总数、可操作数量、预计节省行数。限制:不执行重构;需用户选择模式;需 Python 与 uv、pylint、rg 环境,命令按资料原样使用。