SuperAPI AI 工具集

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

编程与开发

查看项目

更新于 10-16 01:49

技能介绍

用途:这是一条内部 API 演进原则,适用于决定采用新 API 设计、但旧调用方仍存在的场景。核心主张是在同一轮重构中迁移调用方并删除旧 API,而不是保留兼容层。

主要能力与规则:不要仅因内部调用方仍存在就保留旧 API 路径;先盘点调用方,逐一迁移,随后立即删除旧 API;临时适配器应视为例外并设定时限,而非默认架构;更新测试以断言新契约,并删除仅保护重构前实现细节的测试。

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

限制与代价:同时保留新旧 API 会带来双路径复杂度,拖慢清理,使代码库呈现只增不减的状态。资料未提供具体工具、命令、平台或安装方式。