用途:把文件与目录布局漂移的项目整理为单一明确约定,在移动文件的同时更新所有引用(导入、包含、配置、文档、CI),使构建、测试和链接保持通过。
主要能力:先建立引用图再移动;用 rg 枚举入站引用;用 git mv 移动并保留历史与 blame;按约定规则分批提交;每批后跑构建与测试;最后跑文档链接检查并用 git log --follow 确认历史保留;输出 MOVE-MAP.md,含约定一句话规则、old path→new path→referrers 更新表,以及验证命令与 exit 0。
使用方式:开始前 git status --porcelain 必须干净,记录当前目录形态并建立基线绿色;对每个待移动文件运行 rg -n --hidden -g '!.git' '<符号或基名>' 枚举引用,记入 move-map;按批 git mv 并重写引用,每批后跑构建与测试;结束后从已提交树运行完整构建、测试、lint 与链接检查。示例命令:git mv old.go new/old.go;rg -n 'from src.' tests/。
适用场景:测试散落、目录命名混用、根目录杂乱、CI 或路径映射未同步等布局腐化问题。
限制:不要编辑生成、vendor 或 .git/ 路径;不要用 cp 加 rm 代替 git mv;不要在移动中混入逻辑重构;不要用 ls -R 或“看起来整齐”替代真实构建/测试/链接检查。资料未提供具体项目依赖与定价信息。