SuperAPI AI 工具集

dry-refactoring

编程与开发

查看项目

更新于 10-15 23:48

技能介绍

用途:在运行 jscpd 检测出代码克隆后,按引导流程消除复制粘贴式重复。

前置检测:先运行 npx jscpd --reporters ai <path>。混合格式(如 JS 与 TS)可加 --cross-formats "js-ts";较大代码库加 --summary 获取热点概览(含 dup% 列)。默认只报精确副本,应优先重构。重命名副本用 --ignore-identifiers --min-tokens 70;近似副本用 --max-gap-lines 1 --similarity。后两类噪声较大,应在精确克隆处理完后再逐类运行,并视为线索而非缺陷。

工作流:运行检测;解析每条克隆行,识别两处位置与类型(无后缀为精确,(renamed) 为改名,[~N gap] 为中间有改动,[~N ast] 为结构相同的函数对);读取两段代码;理解其作用并列出差异;对重命名与近似克隆先分诊,若两侧语义不同、属有意样板(模型、DTO、配置、路由表、测试夹具)、为生成代码、抽象需含糊命名或不足约 10 行,则跳过并说明原因;设计重构;应用并更新所有调用点;用相同参数重跑确认消除;按影响从高到低重复,并单独报告跳过项及原因。

重构策略:提取函数、提取模块/工具、提取常量或配置、模板/基类、参数化(针对重命名克隆,差异项变为参数;仅差字面量则属缺失常量或配置)、统一近似副本(读取未匹配行,提取公共体并传入差异;若差异改变语义则保留两个函数、只提取公共部分)、合并相似函数(先 diff,ast 分数约 0.9 为一次编辑,0.75 为若干新增语句加改名;低于约 0.8 通常只是惯用法,除非该文件本就是热点)。

务必保证:更新所有调用点而非仅两处;测试通过;抽象命名清晰;重跑使用与发现时相同的检测参数。

提示:优先处理行数最多的克隆;用 dup% 排序;测试文件间克隆可能缺测试辅助函数;跨无关模块可能缺共享工具;跨格式克隆常意味着移植后未删原实现,应合并为一份(通常是 TypeScript)并更新导入;同一文件大量 (renamed) 通常意味着缺一个抽象;测试文件间大量 (renamed) 通常无意义。不要在团队审阅前用 --threshold、--fail-on-new-clones 对 Type-2/Type-3 结果做 CI 门禁,精确运行可门禁。--similarity 覆盖 JavaScript、TypeScript、Python、Java、Kotlin、Scala、C#、Go、Rust、C、C++、PHP、Ruby、Swift、Clojure,也支持 Markdown 代码块及 Vue、Svelte、Astro 脚本;其他语言依赖精确与 --max-gap-lines。可用 --min-lines 10 过滤噪声。CI 门禁时按每组检测参数分别维护 --baseline。