用途:在不中断交付的前提下安全重构与重组既有代码,适用于接手遗留、未测试或 AI/氛围编程生成的代码库。核心原则是“飞行中可回退,落地后加棘轮”:每次提交都保持系统可发布,需要长期破坏主干的重构实为伪装的改写。
主要能力:一是建立双重安全网——行为网(特征测试固定代码实际行为,含缺陷,固定时不得顺手修 bug)与部署信心(可复现构建、冒烟测试门禁、即时回滚;遗留应用优先应用级功能开关而非金丝雀基础设施)。二是把架构名称目标转译为具体痛点,无痛点不排期,稳定无人改的代码保留其混乱。三是按变更频率×复杂度选目标(热点),可用 git log --format= --name-only --since=12.month | sort | uniq -c | sort -rn | head -20 排序;文件常非正确单位,可下沉到函数级,或挖掘同提交共现的隐藏耦合。四是变更受阻时用 Mikado 方法:写下目标、朴素尝试、记录阻塞为前置节点、回退到绿色再逐叶推进。五是每赢得边界即加机器检查(导入禁令、依赖规则、架构测试)。六是过渡结构须带删除条件,如“当无模块导入 Sequelize 时删除”,契约步骤以实测旧路径残留用量为门禁。
使用方式:按任务查阅参考文件——替换在线子系统/依赖/模式/整系统看 references/migration-patterns.md;首次接触陌生继承系统看 references/comprehension.md;接手遗留、未测试或 AI 生成代码库看 references/legacy-rescue.md。边界上,架构技能定目的地与模块边界,测试技能管测试设计,机械强制技能管具体 lint/架构规则,本技能管旅程排序。
限制:资料未提供具体安装命令、收费、平台或效果数据;不适用于无实际变更痛点的整洁度改造,也不以全库转换为参考架构为目标。