SuperAPI AI 工具集

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

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:这是一条关于内部 API 演进的原则,适用于引入新内部 API 而旧调用方仍然存在的场景,用于避免新旧接口长期并存。

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

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

限制与影响:资料指出,同时保留新旧两套 API 会带来双路径复杂性、拖慢清理进度,并使代码库呈现只增不减的状态。是否适合具体项目需自行判断,资料未提供安装命令、代码示例、收费、平台或具体操作步骤。