在复杂项目的代码重构过程中，许多团队容易陷入一个常见误区：试图让单个大模型从头到尾包揽所有工作。而MiMo Code则采取截然不同的策略——它犹如一位经验丰富的指挥官，将庞大任务拆解为可并行执行、可验证、可回溯的子环节，并通过Agent编排实现自动协同。你无需手动编写固定流程，只需借助模式切换、子Agent调度和结构化记忆，就能从“操作工”转变为“指挥官”。
选对核心模式：compose 是代码重构的起点
代码重构不仅仅是修改几行代码，更关键的是理解依赖关系、拆解模块、同步测试以及验证行为。plan模式仅能进行分析，build模式容易陷入局部调整，而compose模式则为这类端到端任务量身定制。它基于一段自然语言描述（例如“将用户鉴权逻辑从session迁移至JWT，并覆盖全部API路由”），自动生成可执行的工作流，并在关键节点支持人工审批。
- 当用户输入自然语言目标后，MiMo Code首先调用explore子Agent扫描整个代码库，识别所有与auth相关的文件、函数及测试用例。
- 随后，plan子Agent输出迁移路径图，明确标注依赖顺序、潜在风险点以及需要手动确认的环节。
- 最后，在compose流程中，自动触发build、test、review三个子Agent并行工作——一个负责修改代码，一个补充单元测试，一个执行diff安全审查。
让子Agent各司其职，避免写入冲突
重构过程中最担心什么？多个Agent同时修改同一文件，或者一个Agent改完而另一个未及时同步。MiMo Code的子Agent系统默认实现了写权限隔离：主Agent仅能发起指令，每个子Agent拥有独立的上下文快照和只读的主仓库副本，所有写操作必须经过审批队列。
- 例如在迁移数据库层时，一个子Agent负责生成新的ORM模型，另一个负责重写DAO接口，第三个专门检查SQL注入风险。它们共享同一份schema描述，但各自处理不同文件目录。
- 如果两个子Agent都试图修改 auth.service.ts，系统会自动暂停并提示冲突，供你选择保留某一版本或合并编辑。
- 所有子Agent的输出均附带结构化元数据（例如“修改了3个函数签名，新增2个类型定义”），便于主Agent统一校验一致性。
利用Cycle机制保持长程上下文
一次重构往往跨越数十轮交互，传统工具容易“失忆”。MiMo Code并不依赖无限扩大窗口来解决，而是采用Cycle机制：当窗口占用率达到20%、45%、70%时自动进行checkpoint，由writer子Agent提取关键信息（例如“已确认UserContext类被12处引用”“JWT secret加载逻辑已统一移至config.ts”）并存储。
- 当你中断会话后重新恢复时，它并非从头加载全部历史，而是读取最新的checkpoint文件重建上下文摘要，跳过冗余对话。
- 这种设计使得跨会话的重构衔接更加稳健——例如第一天完成模型层迁移，第二天直接从“API层适配”继续，不会遗忘昨天删除的旧中间件。
- 注意：checkpoint默认保存在 ~/.mimo/cache/，建议配合Git忽略规则进行管理，以防敏感配置误提交。
通过Goal验证，避免“误以为完成”
重构最危险的不是出错，而是出错时毫无察觉。MiMo Code的Goal机制强制分离“执行”与“验收”：当主Agent宣布完成时，会触发独立的verifier子Agent，利用预设规则（例如“所有 /api/v1/user/** 路由返回状态码200”“JWT token解析失败率 < 0.1%”）执行真实测试或静态检查。
- Verifier不依赖主Agent的描述，而是直接读取Git diff、运行测试套件、抓取本地服务响应。
- 若验证失败，它不会仅简单报错，而是生成debug报告：标出哪条路由未适配、哪个mock数据缺失、哪处类型断言未更新。
- 你可以将Goal写成自然语言形式（例如“登录后首页应显示用户头像和最近三条动态”），MiMo Code会自动将其转换为可执行断言。