该技能是一条重构原则,主题为“先迁移调用方,再删除遗留 API”。当团队确定新 API 是正确设计后,应在同一轮重构中迁移调用方并移除旧 API,而不是保留兼容层。
用途:约束在引入新内部 API 时的处理方式,避免新旧接口长期并存,防止代码库陷入“只增不减”的状态。
主要能力:
- 明确规则:不要仅因内部调用方仍存在就保留遗留 API 路径。
- 要求清点调用方、完成迁移,并立即删除旧 API。
- 将临时适配器视为例外且需限定时间,不作为默认架构。
- 更新测试以断言新契约,并删除仅用于保护重构前实现细节的测试。
适用场景:
- 没有外部用户依赖向后兼容。
- 项目能够承受协调一致的破坏性变更。
- 新 API 属于简化或重构计划的一部分。
限制:资料未提供安装命令、配置方式、运行平台或代码示例;该技能以原则性条文呈现,未说明自动化执行能力。