SuperAPI AI 工具集

less-code-same-behavior

通用与其它

查看项目

更新于 10-16 01:19

技能介绍

用途:对代码库做“分歧与 DRY”审计,定位代码量超出行为所需的地方——同一代码块被复制 N 次、同一关注点被以 N 种形态手写、一个职责散落在多个文件、公共接口导出远超实际使用——并合并成行为完全相同的更少代码。

主要能力:按顺序执行六类检查:1)字面重复;2)同一关注点、形态分歧;3)职责分散;4)接口臃肿;5)类型谎言与配置异味;6)并行词汇(同一概念两个名字)。先读项目声明的架构(分层、导入/依赖契约、公共 API 面),据此确定合并代码可放位置与不可破坏之处。每一步合并都必须在绿灯测试下按小步执行,并做完整类型检查、lint、架构契约检查与相关测试套件,记录前后测试数量。

使用方式:提供脚本做机械统计: python3 scripts/usage_census.py run_coverage --root /path/to/repo python3 scripts/usage_census.py Helper --internal src/pkg/ --json 退出码 3 表示无任何引用(删除候选),报告会同时列出工具仍看不到的情况(按计算名动态派发、生成代码、其他仓库)。

适用场景:需要去重、DRY 化、合并或收敛分歧代码,或在保持行为不变下缩减代码库时。限制与原则:不得在行为需改变时使用;“NO ACTION(不操作)”是一等结论,多数发现不值得改;只有因同一原因变化的代码才可合并,视觉相似但归属不同未来的代码必须分开;删除前须验证所有访问模式(from 导入、属性访问、再导出链、反射与字符串引用、配置/序列化引用);公共接口新增适配层时补等价测试;合并无法二分回滚的不能信任。缺失信息暂未提供。