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

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

github.com/q-qp-p开发146 次安装2 周前更新
代码仓库

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

此技能指导内部 API 重构：将调用方迁移到新契约，并在同一轮改动中删除旧 API。适用于无需维持外部兼容、能够协调破坏性变更的项目。

主要功能

  1. 01盘点现有 API 调用方
  2. 02将调用方迁移至新契约
  3. 03删除旧 API 路径
  4. 04更新测试以验证新契约
  5. 05为例外适配器设定期限

适用场景

  1. 01重构时简化内部 API
  2. 02在无需外部兼容时协调破坏性变更

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/q-qp-p/pstack --skill principle-migrate-callers-then-delete-legacy-apis

安装后在 Claude Code 中输入/principle-migrate-callers-then-delete-legacy-apis确认已加载。

详细介绍

迁移调用方，然后删除旧 API

当我们确定新 API 是正确的设计时，应在同一轮重构中迁移调用方并移除旧 API，而不是保留兼容层。

规则：

  • 不要仅仅因为内部调用方仍在使用旧 API，就保留旧 API 路径
  • 梳理调用方、迁移它们，并立即删除旧 API
  • 将临时适配器视为特殊情况并设定期限，而非默认架构
  • 更新测试以验证新契约，并删除仅用于保护重构前实现细节的测试

适用情况：

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

同时保留新旧 API 会造成双路径复杂性、拖慢清理工作，并让代码库变得只增不减。

评论

支持 Markdown