关于 principle-migrate-callers-then-delete-legacy-apis
面向可协调进行破坏性变更的项目的重构技能。它建议将内部调用方迁移到新 API，并在同一轮重构中删除旧 API，而非保留兼容层。
主要功能
- 01迁移前盘点调用方
- 02将调用方迁移到新 API
- 03及时移除旧 API 路径
- 04按新契约更新测试
- 05为例外适配器设定时限
适用场景
- 01重构时简化内部 API
- 02移除过时的兼容路径
- 03API 契约变更后更新测试
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/principle-migrate-callers-then-delete-legacy-apis确认已加载。
详细介绍
迁移调用方，然后删除旧 API
当我们确定新 API 是正确的设计时，应在同一轮重构中迁移调用方并移除旧 API，而不是保留兼容层。
规则：
- 不要仅仅因为内部调用方仍在使用旧 API 路径，就继续保留这些路径
- 梳理调用方、迁移它们，并立即删除旧 API
- 将临时适配器视为例外并设定期限，而不是默认架构
- 更新测试以验证新契约，并删除仅用于保护重构前实现细节的测试
适用情形：
- 没有外部用户依赖向后兼容
- 项目能够承受协调一致的破坏性变更
- 新 API 是简化或重构计划的一部分
同时保留新旧 API 会造成双路径复杂性、拖慢清理进度，并让代码库显得只增不减。
评论
支持 Markdown