Memo Brain

Memo Brain 记忆管理

这个 skill 的动作语义，以 docs/architecture/command-philosophy.md 为准。

标准动作

• memo awaken
• memo remember
• memo recall
• memo reflect
• memo dream
• memo state

当前能力边界

当前 CLI 没有这些旧接口，禁止再按它们思考或执行：

• memo embed
• memo search
• memo restore
• memo update
• memo merge
• memo delete
• memo list
• --tags
• --after / --before

如果用户表达的是这些旧产品心智，要翻译成标准动作语义；如果当前系统做不到，就直接说明缺口，不要伪造能力。search / embed 只能作为用户自然语言触发词或旧口径警示，不能作为可调用命令示例。

何时使用

适用场景：

• 用户明确要求“记住这个”“记录下来”“保存经验”
• 用户要“查记忆”“之前怎么做的”“还记得吗”
• 需要检查某条记忆的详情
• 需要执行一次 dream / maintenance
• 需要查看当前引擎状态
• 需要通过 dream 维护派生层

不适用场景：

• 只是普通代码搜索或仓库内文本检索
• 当前任务不需要跨对话记忆
• 需要的能力是 update/merge/delete/list 这一类当前尚未落地的旧接口

推荐工作流

唤醒记忆空间

memo awaken

记住内容

标准动作：remember

memo remember "<content>"

如果你已经知道结构化信息，优先补充：

memo remember "<content>" --entity person:Alice --entity place:Paris --fact Alice:lives_in:Paris

回忆内容

标准动作：recall

memo recall "<query>" -n 10

如果你怀疑快路径不够：

memo recall "<query>" -n 10 --deep

反观单条记忆

标准动作：reflect

memo reflect <memory-id>

整理记忆

标准动作：dream

memo dream

如果需要完整派生层维护：

memo dream --full

查看状态

标准动作：state

memo state

如何判断用哪个动作

搜索与记录原则

记录原则

• 只记录值得长期保留的经验、事实、决策或排障过程
• 优先写清内容本身，必要时补 --entity 和 --fact
• 当前没有 tags/update/merge/list 这类接口，不要围绕这些假能力设计工作流
• 默认 remember 不调用 provider；不要把 embedding 写入当成记录入口的默认前提

检索原则

• 查询要包含场景和意图，不要只丢几个关键词
• 先走默认 memo recall
• 只有当默认结果不稳、主题跨度大或用户明确要求更深回忆时，再用 --deep
• 如果要看某条结果的详情，再接 memo reflect
• 默认 recall 不调用 provider；不要承诺缺 provider 时具备完整语义检索能力

维护原则

• 派生层维护统一走 memo dream，需要完整维护时使用 memo dream --full
• dream 可以进入 extraction / embedding 慢路径；不要把这些慢路径包装成 remember / recall 的默认行为
• 用户心智使用 Working Set / Pinned，不把 L0/session 作为外部说明词

常见错误

触发短语

更多可执行示例见 examples.md。