principle-migrate-callers-then-delete-legacy-apis 是协调更换内部接口的 Skill。它先清点调用者,迁到新约定,再删除只为旧调用保留的路径,避免长期维护两套逻辑。
关键前提是没有外部用户依赖兼容,而且项目能承受协同改动。内部也可能有插件、独立发布包或隐藏调用,不能凭目录在仓库内就认定可以一起改。
你提供新接口、旧调用与兼容范围,它帮助安排迁移和相关测试。只保护旧实现细节的测试可以更新,但行为需求不能随旧 API 一并删掉;临时适配确有必要时应写清期限和退出条件,不把“立即删除”当普遍原则。