mimo code 是调度员而非代笔,通过 /goal 拆解任务、plan/build 模式分工、memory.md 绑定规则、自动归档实现文档与代码协同闭环。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

MiMo Code 不是让 AI 替你写文档或代码,而是帮你把“写文档”和“写代码”这两件事拆开、分派、追踪、闭环——它干的是调度员的活,不是代笔。
任务拆解:用 /goal 明确交付标准
AI 程序员容易提前交差,比如你让它“完善登录模块”,它改完 controller 就说完成了,却漏了测试、文档、README 更新。MiMo Code 支持显式设定停止条件,避免这种“伪完成”:
- 输入 /goal 所有接口需有 Swagger 注释,且生成 API 文档 HTML 文件并提交到 docs/ 目录
- 输入 /goal 输出 src/docs/api.md,包含所有路由说明、请求参数、响应示例,并通过 npm run doc:check 验证格式
它会自动把目标拆成子任务:分析现有接口 → 补充 JSDoc → 提取生成 Markdown → 渲染 HTML → 提交 Git → 验证输出。每一步都记录在 tasks/<id>/progress.md</id> 里,你能随时查看卡在哪一环。
角色分工:Plan 模式先定文档,Build 模式再动代码
MiMo Code 提供三种交互模式,其中 Plan 和 Build 的配合最适配“文档先行”流程:
-
Plan 模式:不修改任何文件,只读取项目结构、识别接口、生成文档草稿(如 API 列表、模块依赖图),输出
notes.md或docs/draft.md -
Build 模式:基于 Plan 阶段产出的文档草稿,反向驱动编码——比如根据
docs/draft.md中定义的字段,自动生成 DTO 类、校验逻辑、单元测试骨架 - 切换时只需按 Tab 键,无需重启会话,上下文与记忆(
MEMORY.md)全程保留
记忆绑定:让文档和代码共享同一套规则
很多工具写完代码就忘了文档约定,MiMo Code 把文档规范也存进项目记忆层:
- 首次运行时,它会创建
MEMORY.md,你可以手动填入:
- 所有 REST 接口必须带 OpenAPI v3 注释
- 文档输出路径固定为 docs/api/
- README 中的“快速开始”部分需含 curl 示例 - 后续每次任务,它都会参考这份 MEMORY,自动检查是否遗漏文档更新,甚至能对比
git diff判断哪些新接口还没写文档 - 当多人协作时,
MEMORY.md可随 Git 提交,成为团队可维护的“AI 协作契约”
自动归档:文档生成即入库,不靠人提醒
它不只生成文档,还确保文档落地:
- 执行 /doc generate --format=html --output=docs/api/index.html 后,自动运行
git add docs/api/ && git commit -m "chore(docs): update API reference" - 若检测到
package.json中配置了"doc:build"脚本,会优先调用该命令而非硬编码构建逻辑 - 生成的文档文件名、目录结构、版本标记(如
v1.2.0)均可在checkpoint.md中持久化,下次续跑时自动沿用











