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