memory-admin当用户需要对记忆库做"运维级"操作时使用。具体场景: (1) 备份 / 恢复 (backup, restore); (2) 看记忆总量 / 类型分布 (stats); (3) 去重 (dedupe) — 同 type+title 保留最新版本,旧的硬删; (4) 清理过时记忆 (prune --status / --older-than); (5) 安全审计 (audit) — 扫描已存记忆里是否含密码/API key 等敏感数据。 注意:dedupe 与 prune 都是不可逆操作(默认会真删),跑前要让用户确认 scope。
memory-capture当用户希望把一条信息长期保存进记忆库时使用。具体场景: (1) 用户说"记住" / "以后" / "remember this" / "save this for later"; (2) 用户给出一条偏好 / 项目背景 / 环境配置 / 故障排查结论希望持久化; (3) Agent 在 commit / reflection 流程里识别到值得长期保存的事实。 执行前自动跑敏感数据检测、按记忆类型路由到对应 scope,写入失败会原样 抛回错误(不会静默丢失)。
memory-commit当一段会话结束、需要把"这次对话学到的东西"沉淀进长期记忆时使用。 具体场景: (1) 用户说"保存这次对话的要点" / "把刚才的经验记下来" / "commit memory"; (2) 长会话结束前定期 / 自动 checkpoint,从 session 中抽长期价值的事实; (3) Agent 自身在重要决策 / 排障收尾后主动沉淀经验。 默认输出"候选预览"供用户确认;加 --apply 才真正写入(避免污染记忆库)。
memory-doctor当 memory 操作出错或要验证 memory plugin 配置时使用。具体场景: (1) 用户报告"记忆操作失败" / "recall 没结果" / "capture 报错"; (2) 首次部署或切换后端 (HTTP / MCP / mem0) 后验证连通性; (3) 怀疑 identity / API key / scope 配置有问题; (4) 用户主动说 "doctor" / "检查记忆系统" / "memory health check"。 会跑配置检查 + 后端 ping + 默认 identity 安全断言;--mode full 还会做 写→搜→读→删的端到端闭环测试。
memory-recall当用户请求查找/回顾长期记忆时使用。具体场景: (1) 用户问"之前关于 X 的记录" / "上次怎么处理的"; (2) Agent 启动新任务前需要从长期记忆里拉项目上下文 / 用户偏好 / 历史故障案例; (3) 任何包含 recall / remember / 之前 / 上次 / previously / what did 等触发词的请求。 返回的记忆按相关度排序,以结构化块形式直接注入上下文。
memory-share当用户希望把一条已有记忆共享 / 取消共享给另一个 agent / user / team,或想列出 已共享给自己的记忆时使用。具体场景: (1) 用户说"把这条记忆分享给 X agent" / "share memory <id> with <ident>"; (2) 用户说"取消 / 撤销分享" / "unshare from"; (3) 用户问"我能看到哪些别人共享过来的记忆" / "what memories are shared with me"; (4) Agent 完成任务后想把成果记录共享给团队(写到 team scope 或显式 shared_with)。 覆盖 read /