mimo code 通过初始化、规划、组合执行、验证与渐进交付五步实现安全可验证重构：先 mimo init --root . 声明根路径，再 mimo project setup 构建依赖图；用 mimo plan 分析影响面，确认后以 mimo compose 驱动全流程；支持自然语言或结构化指令批量修改，所有变更经 git staging、自动 lint/type-check、关联测试与 smoke test 验证；最终渐进替换、保留旧模块、逐点验证、提交带验证结果的 commit。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用 MiMo Code 完成一次安全、可验证的代码重构，不是输入指令就等结果，而是先让 AI 看懂你的项目结构、识别风险边界、再分步执行并自动验证。它不跳过分析直接改，也不在改完后才告诉你哪里崩了。
启动前必须完成的初始化
进入项目根目录后，立即执行 mimo init --root .。这一步【必须显式声明根路径】，否则 MiMo Code 会误扫描 node_modules 或 dist 目录，导致上下文污染和 token 浪费。
接着运行 mimo project setup，按提示输入主入口文件（如 src/index.ts 或 app.py）。工具将基于此文件构建静态依赖图，只加载真实参与调用链的源码文件。
若项目含 CLAUDE.md，确保其中已写明技术栈现状（如“当前为 Vue2 + Options API，目标为 Vue3 + Composition API”）和必须保留的模块（如支付回调处理逻辑），这是后续所有重构决策的锚点。
选择正确的模式启动重构
重构任务不能在 Build 模式下盲目执行。先用 Plan 模式探路：
输入 mimo plan "找出所有使用 this.$http 的 Vue 组件，并标记其请求参数与响应结构"。它会返回带引用路径的结构化摘要，而非零散代码片段。
确认分析结果无误后，切换至 Compose 模式驱动端到端流程：mimo compose "将用户鉴权逻辑从 session 迁移到 JWT，并覆盖全部 API 路由"。该模式会自动调用 explore→plan→build→test→review 子 Agent 并行工作，而不是让你手动拼接命令。
注意：Plan 模式输出的「影响面评估」和「推荐 Git 分支策略」必须人工确认后再进入 Compose，否则可能绕过关键风险检查点。
执行跨文件批量修改
方法一：自然语言驱动原子替换
在 Compose 流程中，直接输入：把 src/utils/http.js 中的 fetchWrapper 重构为使用 axios 实例，并保持所有调用处行为不变。MiMo Code 会先列出全部引用位置，检查返回类型、错误处理方式、超时配置是否一致；若某处依赖原函数的特定抛错格式，它会同步更新该调用点的 try/catch 逻辑。
方法二：结构化指令控制粒度
输入：refactor --files "src/api/**.ts" --from "fetch" --to "axios.get" --preserve-signature。该指令强制保留函数签名，避免 TypeScript 类型断裂；同时自动跳过测试文件中的 mock 实现，防止误改。
所有修改均走 Git staging 流程，支持 diff 预览和一键撤销，【不直接覆盖源码】。
验证改动是否真正安全
第一步：自动触发本地验证链路
修改完成后，MiMo Code 默认运行 lint + type-check。若失败，立即回退变更并定位到具体报错行，不会继续执行后续步骤。
第二步：按需重跑关联测试
检测到 Jest 测试存在时，自动匹配 import 路径，重跑相关 test suite，并高亮新增/失败用例。例如迁移 API 封装后，它会精准触发 auth.test.ts 和 user-api.test.ts，而非全量跑测试。
第三步：关键路径 smoke test
若项目含 Vite/Nuxt 构建配置，可一键启动本地服务，用 curl 快速验证 /api/login 等核心接口的状态码与响应结构是否符合预期。
渐进式收尾与交付
① 先生成新模块（如 src/lib/apiClient.ts），保留旧模块暂不删除；
② 逐个迁移调用方，每改一处就验证该文件的测试是否通过；
③ 最后才移除旧实现，并更新文档和 README 中的示例；
④ 所有操作记录在 Git 提交中，每个 commit 都附带简要说明和验证结果。
