SuperAPI AI 工具集

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

编程与开发

查看项目

更新于 10-28 16:16

技能介绍

该技能名为 principle-migrate-callers-then-delete-legacy-apis,用于在 API 或数据模式替换旧契约时,选择迁移策略并界定验证边界。它同时服务于 Matt 的工单流程和 Pstack 操作手册。

用途 当新契约取代旧契约时,决定采用协调式调用方迁移与删除,还是为真实兼容性义务采用分阶段共存。

主要能力

  1. 清点所有调用方与兼容性义务,包括外部消费者、独立部署版本、存储数据以及发布或回滚要求。完成条件是已知旧契约的消费者及其所需生命周期。
  2. 若调用方均为内部且项目可承受协调变更,则在一个验证单元内迁移每个调用方并删除旧 API。仅存在内部调用方不足以证明需要兼容层。多个有界工单可在隔离的集成分支上共同构成该单元。完成条件是计划覆盖每个调用方、删除过时路径以及该单元的检查。
  3. 仅当存在真实兼容性义务或需要独立绿色发布时,才使用 expand-contract。添加新形式,按受检批次迁移消费者,并在义务结束后移除旧形式。为每个临时适配器设定移除条件和负责工单。完成条件是共存原因及其退出闸门明确。
  4. 为每个工单或迁移阶段以及最终集成单元声明检查。隔离单元内部可以存在计划内、有范围、可回滚的破坏;通过阶段检查可解锁该单元内的下一个工单。该单元之外的工作保持阻塞,直到其完整的静态、运行时和契约检查通过。保留已批准的发布契约;更改前需寻求决策。完成条件是中间进展与最终验收不会混淆。
  5. 为已接受的契约更新测试。保留不同的行为回归,同时删除仅保护已退役实现的测试。完成条件是调用方清点已穷尽、所需兼容性得到遵守、过时路径在其声明的闸门处移除,且最终单元的检查通过。

使用方式 该技能以原则形式提供,用于指导迁移决策与验证边界划分。具体调用方式、安装命令或集成步骤暂未提供。

适用场景 适用于 API 或数据模式替换旧契约的迁移工作,尤其是需要判断是否引入兼容层、如何分批迁移消费者、如何设定临时适配器移除条件以及如何划分验证单元的场景。

限制 资料未提供具体平台、收费、价格或效果信息。该技能为原则性指导,不包含可直接执行的代码或安装命令。