SuperAPI AI 工具集

cleanup-codebase

通用与其它

查看项目

更新于 10-16 03:14

技能介绍

用途:在因其他任务编辑某个文件时,顺手移除不产生价值的内部代码,降低读者需要跟踪的概念数量。

主要能力:删除死代码、死字段、死配置与陈旧状态;内联只做重命名或转发的包装器;合并结构等价的本地类型;消除跨服务或跨结构镜像的重复状态;更新与代码矛盾的注释。

核心原则:每个契约只有一个真实所有者;只在移除真实耦合或保护真实边界时才引入间接层;调用方与被调方都在本地且无真实边界时直接同步修改;清理只做删除,不新增抽象。

使用方式:在文件中发现候选后,用 git --no-pager grep -n 或 ast-grep 确认无消费者,检查耦合影响,将清理作为独立原子提交(可用 git move --fixup 拆分),执行删除而非注释掉,再运行构建、测试与类型检查,并搜索文档、错误信息、配置键、环境变量中的残留引用。

适用场景:编辑无关功能时发现死字段;重构删除代码路径后遗留的包装器、死分支或失效开关;审查 PR 中不必要的包装或重复状态;新人梳理可确认的死代码候选。

限制:不适用于独立的“清理扫荡”PR、未触碰的文件、无法证明安全的推测性删除,以及公共 API 表面(属于破坏性兼容重构范畴)。验证门包括原子提交、死代码确认、无新抽象、构建测试通过、幽灵引用搜索。退出码 0 表示干净完成,11 至 15 分别表示发现未预期消费者、构建回归、混合关注点提交、引入新抽象、存在幽灵引用。具体命令与配置细节以原始资料为准。