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 不是记事本，而是技术债务的活地图。