用途:管理代码生命周期中的弃用与迁移,适用于需要移除、替换或迁移已有功能/API、版本升级、清理废弃代码的场景。入口是移除或替换已有功能、API 版本升级、清理废弃代码;出口是迁移计划、兼容层(如需要)、文档与清理,完成后回到正常 build 流程。前置加载 CANON.md,输出路径为 verify-workflow-review。
主要能力:提供弃用决策框架(是否有替代方案、还有多少用户、迁移成本由谁承担、时间线是否合理、能否紧急回退);区分强制弃用与必须弃用;给出迁移模式,包括 Strangler Pattern(新旧并存、逐步迁移、旧系统流量降至 5% 后关闭)、Adapter Pattern(旧消费者经 v1 adapter 转换后委托 v2 handler)和 Feature Flag 迁移(按用户开关切换新旧代码路径);提供迁移决策流程图、反模式修复表、好/坏弃用公告对照、僵尸代码定义与常见说辞的现实后果、红旗清单、验证失败处理、人类伙伴信号、输出模板与验证清单。
使用方式:先回答弃用决策问题,再按流程图选择突发弃用或渐进弃用;多消费者用 Strangler,单消费者用 Adapter 或直接替换;需要兼容期用 Feature Flag。弃用公告需包含运行时警告、迁移指引和截止日期三要素。完成后按输出模板记录弃用目标、替代方案、弃用类型、截止日期、消费者影响评估、迁移时间线、回退计划与已知限制,并逐项核对验证清单。
适用场景:API 版本升级、功能下线、旧系统替换、废弃代码清理、breaking change 管理。
限制:不适用于仅新增功能、不移除或改变已有行为的情况;不适用于废弃范围没有使用数据、兼容要求或迁移窗口的情况;也不适用于删除本任务中新建且尚未发布的临时代码。资料未提供具体工具链、平台或收费信息。