SuperAPI AI 工具集

cleanup-dedupe

编程与开发

查看项目

更新于 10-16 04:57

技能介绍

用途:查找重复代码并在确实能降低复杂度时进行合并,避免过早抽象带来的危害。

主要能力:使用 jscpd 进行多语言克隆检测,命令为 bunx jscpd --min-tokens 70 --min-lines 30 --threshold 0 --reporters json --output /tmp/jscpd-out .(无 bunx 时回退 npx)。解析 jscpd-report.json 中的 firstFile、secondFile、lines、tokens 与片段,先剔除 node_modules、dist、build、.next、generated、测试镜像、类型定义与迁移文件的匹配,再评估。

信心分级:HIGH(≥30 行且 ≥70 令牌、令牌完全一致、函数签名相同、位于同工作区且有明确共享包、非测试与生成代码)才自动提取;MEDIUM 仅报告,包括存在 1-3 处差异、需新建共享包、15-29 行的边界情况;LOW 仅记录,如结构性相似或测试样板。执行时先确定落点(同包用现有 lib/ 或 utils/,跨包仅在已有共享包时使用),创建工具文件、替换引用、删除原实现,并单次提交。验证命令为 bun run check 2>&1 || npx tsc --noEmit && npx eslint .、bun test 2>&1 || pytest 2>&1,并重跑 jscpd 确认下降;验证失败则回滚并全部降级为 MEDIUM。

限制:在 git 工作区不干净时拒绝自动应用;不得从生成文件、.d.ts 或迁移文件提取;不得自动创建共享包;不得仅凭 prop 模式相似提取组件;不得改变任一来源的函数签名;不得 DRY 测试用例或错误处理、副作用不同的代码。报告输出至 .claude/cleanup-reports/cleanup-dedupe-{YYYY-MM-DD}.md。