SuperAPI AI 工具集

principle-migrate-callers-then-delete-legacy-apis

编程与开发

查看项目

更新于 10-16 16:28

技能介绍

该技能用于在引入新内部 API 时指导重构决策。资料指出,当团队认定新 API 是正确设计时,应在同一波重构中迁移调用方并移除旧 API,而不是保留兼容层。

规则要求:不要仅因为内部调用方仍然存在就保留旧 API 路径;盘点调用方、迁移它们并立即删除旧 API;将临时适配器视为例外并设定时间限制,而不是默认架构;更新测试以断言新契约,并删除仅保护重构前实现细节的测试。

适用条件:没有外部用户依赖向后兼容;项目能够承受协调式破坏性变更;新 API 属于简化或重构计划的一部分。

资料说明,同时保留新旧 API 会带来双路径复杂性、拖慢清理,并使代码库呈现只增不减的状态。