AI 遗留代码重构：保持行为的渐进迁移工作流

让代理识别入口、消费者、持久数据、定时任务、外部协议和部署单元，并引用代码或文档；未知行为必须明确标记，不能靠猜测填补。

与维护者核对所有权和运行约束。仅来自 import 的依赖图不足以代表真实运行集成。

在公共 API、事件、数据库效果、文件或用户输出处增加测试；加入脱敏后的边界与错误样例，并标注可疑行为，避免测试把缺陷静默固化成永久需求。

选择一个端点、命令、数据适配器或包边界作为切口，让代理提出保持公共行为的文件级方案和测试。不能只凭架构摘要就批准全仓重写。

格式化和无关清理移出迁移 diff；小变更能保留 blame 历史，也更容易定位行为差异。

在条件允许时，用同一组脱敏 fixture 或影子输入运行新旧实现，比较外部有意义的输出。差异必须分类为预期契约变化、容许的非确定性或缺陷。

双路径需要资源上限和明确写入规则，不能为了对比而复制不可逆的生产副作用。

每个切片都应通过特征测试、新契约测试、包级检查、审查和回滚演练。渐进发布期间观察错误与资源使用；消费者、数据、文档和告警迁移完成后才删除旧代码。

切片落地时同步更新架构文档、代理说明、所有权、构建命令和 runbook，并删除过时规则，避免后续会话继续把工作导向已下线模块。