用途:为大型代码库重构与显式迁移提供结构化方法,分三阶段——审计(理解并冻结问题)、迁移(按切片逐项偿还技术债并留证)、收尾(清除残留并证明仓库可发布)。面向从“命名来源”迁移到“命名目标”的场景,解决四类失败:会话漂移、残留代码、凭直觉的自信、虚假完成。
主要能力:以控制面工件驱动流程,包括 CHARTER.md(使命、关键工作流、外部面、不变量、非目标、护栏、发布门)、DECISIONS.md、SLICES.yaml、MAP.csv、RATCHETS.yaml、SHIP_CHECKLIST.md 与 HANDOFF.md。每个会话开始时按顺序读取这些工件并运行 guard 脚本;结束前写 HANDOFF.md,含变更、现状、剩余、发布阻塞与下一步。审计阶段盘点代码/测试/文档/配置并分级,用 grep/ripgrep 计数反模式,并以 CI Ratchet 将预算固定为当前计数,只减不增。迁移阶段按切片执行五步生命周期:开始、TDD 构建、清理扫描、验证、关闭,要求同一切片内删除被替换代码。收尾阶段重跑清单、全库残留扫描、依赖清理、运维面同步并执行 SHIP_CHECKLIST.md。
使用方式:按资料给出的会话协议与阶段顺序操作;guard 脚本等命令与模板路径保持原样;资料未提供具体仓库代码,命令细节暂未提供。
适用场景:累积技术债的代码库迁移与收敛项目。限制:需要完整代码库访问以校准预算;手动/硬件/第三方界面需人工验证;资料未说明安装方式、运行环境或支持平台。