用途:指导移除向后兼容与遗留层,完成破坏性重构。适用于 API 现代化、清理迁移债务、删除兼容 shim 或旧代码路径。
主要能力:提供侦察清单(查找 @deprecated 标记、版本门控代码路径、适配器/桥接层、双序列化格式、仅验证旧行为的测试、兼容开关配置、转发模块、弃用承诺)、“是否破坏”决策表、执行策略、反模式清单、验证门与退出码(0 干净破坏、1 部分残留、2 测试失败、3 发现外部消费者需迁移计划)。
使用方式:先映射影响范围(用 ast-grep、rg 等检索所有引用,而非猜测);确保旧路径有测试覆盖,必要时先补特征测试;删除旧路径而非注释;迁移所有调用点并分批编译/类型检查;删除孤立测试;检索字符串、配置键、环境变量、文档与错误信息中的残留;检查无用导入与依赖。
原则:不做半吊子迁移;只允许旧到新单向迁移;兼容 shim 若无移除日期即为永久架构,需明确取舍;删除而非注释。
限制:资料未提供具体安装命令、运行命令、价格、平台支持或版本信息。