MiMo Code项目记忆：如何标记技术债务并存入AI记忆库

MiMo Code 的技术债务管理本质上是一张结构化、可检索、能主动介入的“活地图”。每条债务条目必须详细记录模块位置、类型、原因等必填字段，底层通过 SQLite FTS5 实现全文索引与语义检索。在开发的关键节点（如规划、提交前审查），系统会自动弹出提醒，甚至强制要求处理——它不会被动等待你翻阅记录，而是主动推送到你面前。

技术债务标记远不止随手写一个 TODO 那么简单。关键在于让 MiMo Code 真正“记住它、理解它，并在后续主动提醒你”。它的项目记忆（MEMORY.md）并非静态笔记，而是一个经过 SQLite FTS5 全文索引的结构化知识节点。AI 在执行规划、审查、重构等任务时，能够主动调取这些信息——前提是你必须按照规范操作。

技术债务需附带上下文才能存入记忆库

如果只写一句“TODO: 优化登录接口”，系统会直接忽略。MiMo Code 只收录那些带有明确背景、影响范围和判断依据的条目。换言之，它需要知道：这是谁留下的？为什么被视为债务？不修改会引发什么问题？修改会带来什么副作用？

• 必填字段：模块位置（例如 auth/service.go）、债务类型（耦合/重复/过期依赖/硬编码）、触发原因（例如“因 v3.2 API 升级导致兼容层冗余”）
• 推荐补充：关联的 PR/Issue 编号、当前阻塞的业务需求（如“阻碍 SSO 接入”）、临时规避方案（如“已加 fallback 日志但未降级”）
• 格式示例：
  

  [TECH-DEBT] auth/service.go —— 耦合型
    ▸ 原因：LoginHandler 直接调用 DB 层，绕过 Repository 抽象层（违反 clean architecture）
    ▸ 影响：无法在测试中 mock 数据源；阻塞「多租户隔离」需求（#421）
    ▸ 临时方案：已加 @Deprecated 注释，保留旧路径供 legacy client 使用

使用命令行一键注入，避免手动修改 MEMORY.md

MiMo Code 提供了一条专用指令，以确保内容被正确解析、索引，并关联到具体的代码位置。手动编辑 MEMORY.md 不仅容易搞错格式，还可能跳过 FTS5 索引更新——那样就等于白记了。

• 运行 mimo debt add --file auth/service.go --type coupling --reason "violates repository layer"
• 系统会自动提取文件的 AST 结构，将债务锚定到具体的函数或类型上（比如 LoginHandler.ServeHTTP），而非整行文本
• 注入后立即触发本地 FTS5 重建，5 秒之内，你在后续会话中询问“哪些地方违反了 clean architecture？”就能被语义检索命中

让债务在关键节点自动浮现，而非等你翻记录

存入记忆库只是第一步。MiMo Code 的记忆系统会在你执行相关操作时主动介入，将债务转化为可行动项。

• 当你修改 auth/ 下任意文件时，AI 会弹出提示：“检测到对 auth 模块的变更，关联 2 条技术债务，是否纳入本次重构范围？”
• 执行 mimo plan --feature sso-integration 时，系统自动将 #421 对应的债务列为前置任务，并生成迁移路径（例如“先抽离 DB 调用 → 再注入 Repository 接口 → 最后移除旧 handler”）
• Git commit 前运行 mimo review，若改动触及已标记的债务区域，会强制要求填写 --resolve-debt 或 --defer-reason 参数

真正有效的技术债务管理，是让 AI 将其视为真实存在的代码资产——像读取代码一样读取它、查询它、调度它。MiMo Code 不是记事本，而是技术债务的活地图。

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：MiMo Code项目记忆：如何标记技术债务并存入AI记忆库要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题