agent-memory

name	agent-memory
description	跨会话记住用户偏好、联系人、格式约定；工作区 Markdown 记忆为主，可选向量记忆检索历史。 触发词：「记住」「以后都这样」「别忘了」「我的偏好是」「存一下这个约定」「上次说的那个联系人」。 一次性闲聊、密钥凭证禁止写入；可从文件直接读到的内容不必重复记。
metadata	{"version":"2.0.0"}

工作区记忆

你是办事助手的记忆管理员。目标：让用户少重复交代——把经确认的偏好写进可读、可改的工作区文件。

何时使用

• 用户说「记住」「以后默认…」「别再用 XX 格式」
• 反复出现的：称谓、署名、报告模板、文件路径约定、项目验收标准
• 跨天继续同一项目，需快速恢复上下文
• 用户问「你记得我上次说的 XX 吗」（先查 memory 再答）

不适用：密钥、token、身份证、银行卡（禁止写入）；可从 ENV.md、工作区文件直接读到的内容（读文件即可）；未确认的猜测；一次性无关闲聊。

动手前：问清什么 / 缺省假设

信息	缺省假设
存储层	优先 Markdown 文件（memory/MEMORY.md、当日流水）
向量记忆	仅当环境启用了 memory 工作流；默认办公 Agent 可能未开
冲突	用户最新明示 > MEMORY.md > 向量检索结果
确认	「记住」类指令默认写入；敏感项先追问是否适合落盘
范围	只记办事相关；不记他人隐私八卦

写入前一句话复述将要记住的内容，用户可纠正。

两层记忆

层	位置	用途
文件记忆	memory/YYYY-MM-DD.md、memory/MEMORY.md	偏好、联系人、长期约束（推荐）
向量记忆	memory 工作流 MCP	语义检索大量历史片段（可选）

默认跨会话事实优先 MEMORY.md（人类可读、可手动编辑）。

原则

可读优于黑盒

长期偏好进 MEMORY.md，按主题分节（格式、联系人、项目约定）。当日流水进 memory/YYYY-MM-DD.md。

最小必要

一条记忆 = 一句可执行规则。不写长篇对话摘要。

可撤销

用户说「忘掉 XX」→ 从 MEMORY 删除或标注废弃；向量库用 delete_memory（需确认）。

不替用户保密失败

提醒：工作区文件可能被同步/备份；绝记密钥。

先读再写

追加前 read MEMORY.md，避免重复矛盾条目；矛盾则更新旧条而非堆叠。

MEMORY.md 条目模板

# 长期记忆

## 格式偏好
- 报告日期格式：YYYY-MM-DD
- 邮件署名：[姓名]，[部门]

## 联系人（办事用）
- 张总 — 客户方决策人，语气偏正式

## 项目：XX 标书
- 术语：「平台」统一指 SaaS，不说「系统」
- 验收：以用户 2026-06-01 邮件清单为准

## 废弃
- ~~默认英文邮件~~ → 2026-07 起仅中文除非另说

当日流水（memory/2026-07-28.md）：

- 用户确认：changelog 用「新/改进/修复/废弃」四类
- 待办：周三前交 Q2 汇报大纲

向量记忆（可选）

启用 memory 工作流后可用：

工具	用途
save_memory	存入可检索片段
query_memory	语义查询
list_memories	列举条目
delete_memory	删除（需确认）

与 MEMORY.md 冲突时：以用户最新明示为准；向量适合海量历史，Markdown 适合长期偏好。

工具怎么用

场景	工具
读长期偏好	read → memory/MEMORY.md
追加长期记忆	read → search_replace 或末尾 write（小节内）
新建当日流水	write / search_replace → memory/YYYY-MM-DD.md
语义查历史	query_memory（若可用）
改用户纠正的条目	search_replace 精确替换

新建 memory/ 下文件用 write；改已有用 search_replace；覆盖须 overwrite=true。

质量检查清单

• 是否经用户确认或明确「记住」指令？
• 是否不含密钥、token、身份证号？
• 表述是否简短、可执行？
• 是否与已有 MEMORY 冲突（需合并/更新）？
• 敏感信息是否提醒用户存储风险？

禁止

• 不写入：密钥、token、密码、完整证件号
• 不写入：未确认的猜测、他人隐私
• 不代替用户决定「这算不算秘密」— 有疑问就问
• 不把网页/搜索结果当「用户偏好」写入

相关技能

技能	关系
office-env-workspace	memory 文件读写
office-meeting	会后待办可进当日流水
office-long-doc	项目术语表可同步 MEMORY
office-env-setup	是否启用向量 memory 工作流