SuperAPI AI 工具集

deprecation-and-migration

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:该技能面向移除旧系统、迁移用户、清理未使用代码和替换已废弃依赖等场景,核心思路是把代码视为负债,需要靠存在价值来证明其合理性,删除的每一行代码都是未来不必维护的代码。

主要能力:区分两种废弃类型。建议性废弃(Advisory Deprecation)包括在文档和类型标注中标记已废弃、使用时记录警告、提供清晰迁移路径并设定移除时间线;强制性废弃(Compulsory Deprecation)包括添加无法静默的运行时警告、设定硬性移除日期、向所有受影响团队沟通时间表,并在可能时提供自动化迁移工具。

迁移模式:Strangler Fig(新系统与旧系统并行搭建,新流量先路由到新系统,再逐步迁移存量流量,全部迁移后移除旧系统);Parallel Run(双系统同时运行,流量同时发送到两者并比较输出一致性,建立信心后切换并移除旧系统);Feature Flag Cutover(新系统先部署在开关后,依次对内部用户、部分外部用户、全部用户启用,最后移除开关和旧代码)。

僵尸代码清理:搜索不可达的导出、检查无引用文件、查找已导入但从未调用的依赖,在测试覆盖剩余路径的前提下放心删除。

使用方式(流程):第一步梳理要废弃的对象,审计旧系统使用情况、识别所有依赖方、评估迁移复杂度;第二步沟通计划,记录废弃时间线、提供迁移指南并通过合适渠道公告;第三步实现迁移路径,添加废弃警告、提供迁移工具或脚本、更新文档;第四步移除旧系统,确认所有使用方已迁移后删除已废弃代码并清理相关配置与文档。

验证要求:废弃时间线已记录并传达、迁移路径清晰且经过测试、移除前所有使用方均已迁移、旧代码及配置与文档均已删除。

常见辩解与反驳:认为旧代码无害其实会增加认知负担、维护成本和体积;“可能有人在用”应通过使用审计和废弃窗口解决,要么发布要么删除;认为迁移太具破坏性,但渐进迁移可最小化干扰,突然中断才会最大化干扰;“我会标记废弃但不移除”,而仅标记不移除只是文档,目标就是移除。

限制:资料未提供具体平台、语言、依赖项或收费信息,暂未提供相关细节。