| 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、密码、完整证件号
- 不写入：未确认的猜测、他人隐私
- 不代替用户决定「这算不算秘密」— 有疑问就问
- 不把网页/搜索结果当「用户偏好」写入
相关技能
| 技能 | 关系 |
|---|
| office-env-workspace | memory 文件读写 |
| office-meeting | 会后待办可进当日流水 |
| office-long-doc | 项目术语表可同步 MEMORY |
| office-env-setup | 是否启用向量 memory 工作流 |
