SuperAPI AI 工具集

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

编程与开发

查看项目

更新于 11-19 03:05

技能介绍

该技能是一条重构原则,主题为“先迁移调用方,再删除遗留 API”。当团队确定新 API 是正确设计后,应在同一轮重构中迁移调用方并移除旧 API,而不是保留兼容层。

用途:约束在引入新内部 API 时的处理方式,避免新旧接口长期并存,防止代码库陷入“只增不减”的状态。

主要能力:

  1. 明确规则:不要仅因内部调用方仍存在就保留遗留 API 路径。
  2. 要求清点调用方、完成迁移,并立即删除旧 API。
  3. 将临时适配器视为例外且需限定时间,不作为默认架构。
  4. 更新测试以断言新契约,并删除仅用于保护重构前实现细节的测试。

适用场景:

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

限制:资料未提供安装命令、配置方式、运行平台或代码示例;该技能以原则性条文呈现,未说明自动化执行能力。