memo-brain

name	memo-brain
description	管理和检索跨对话的上下文记忆。公开动作语义以 command-philosophy 为准。适用于“记住这个”“查记忆”“整理记忆”“看看当前状态”等场景。

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

如何判断用哪个动作

用户意图	标准动作	当前执行建议
“记住这个结论”	remember	memo remember ...
“之前有没有类似经验”	recall	memo recall ...
“把这条记忆展开看看”	reflect	memo reflect ...
“整理一下记忆”	dream	memo dream
“现在系统里有什么状态”	state	memo state
“索引可能不一致，恢复一下”	dream	memo dream --full

搜索与记录原则

记录原则

• 只记录值得长期保留的经验、事实、决策或排障过程
• 优先写清内容本身，必要时补 --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 作为外部说明词

常见错误

❌ 不要	✅ 应该
继续调用 memo search / memo embed	先转成标准动作语义
假装旧命令仍然是标准	直接使用 awaken/remember/recall/reflect/dream/state
伪造 update/merge/delete/list 能力	直接说明当前未实现
把 extract 当成主记忆入口	只围绕公开动作语言组织心智
把 memo restore 当成标准维护动作	使用 memo dream，必要时使用 memo dream --full
用 L0/session 解释用户可见状态	使用 Working Set / Pinned

触发短语

动作	触发短语
remember	“记住这个”“记录下来”“保存这个经验”
recall	“之前怎么做的”“查记忆”“还记得吗”
reflect	“把这条记忆展开看看”“看看详情”
dream	“整理一下记忆”“跑一次 dream”“恢复派生层”“恢复索引状态”
state	“看看现在状态”

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