用途:审计代码库中造成维护成本、让人和智能体困惑的代码,通常是未使用、重复或过度设计。流程分五阶段。一、定向:确定边界,考虑跨仓库互操作影响;查看近期变更定位热点;检查架构、规则等。二、调查:找出死代码、重复或漂移的逻辑、过度工程、不符架构模式的代码等。三、验证:对每个候选,在整个边界内枚举引用,注意 grep 看不到的引用方式,尤其是公开 API 端点无法看到全部调用方。四、分类:Tier 1 可证明死亡,零引用且无动态或外部可达,连同测试删除;Tier 2 代码死亡但留下数据,先删代码、数据另行决定;Tier 3 有明确归属的重复,合并到测试最好的实现;Tier 4 可疑但未证实或边界外可达,只报告不删除并说明需什么证据。过期断言如不实的注释、文档、规格应立即修正。五、分波删除:从叶子开始,先测试、再调用方、再实现、最后数据文件或模块,波次间运行相关测试套件,每波可独立回滚,不混入重构。输出需包含:Tier 1 删除的文件路径、行数及证明枚举;Tier 3 合并的副本、保留者与测试;Tier 4 可疑点与所需证据;已修正的过期断言;影响说明。原则:要证明而非自信;删除是最好的重构;代码审计不删数据;先修误导性内容;每次变更只处理一件事。限制:Grep 无法看到所有引用,删除前必须完整枚举;公开 API 等外部可达处不得仅凭找不到调用方就删除。具体安装命令与更多信息暂未提供。
gjalla-cleanup-audit
编程与开发
更新于 10-15 21:52