下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/indiv-syc--agent-memory-skill.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @indiv-syc/agent-memory-skill。- Agent 记忆系统技能。当用户要求「记住这件事」「回忆/查记忆」「养 agent 人格」「配置记忆系统」「初始化记忆目录」「写记忆」「防失忆」「给 agent 加长期记忆」「记住我是谁/怎么认出我」「给 agent 定规矩」「让 AI 自动保存/自动读取记忆」「什么时候该记下来」「哪些记忆该长期留」「不用我提醒就自动调用记忆库」时使用。人格层含主人档案、关…
- 规范规则 rules.md 含 R11 自动触发(保存信号 T1–T11 / 读取信号 U1–U8)、R12 留存分级(永久/长期/中期/会话态)、R13 常驻锚点(让 AI 永远记得自己有记忆库)、R14 目录分层(深层存近期与重要、浅层存久远日常,省 token)
- R15 人格设定保护(安装绝不覆盖用户既有设定,脚本层已硬保护,`main/` 两文件 `–force` 也不覆盖)。人格、经验、事实分三层,记忆目录再分深浅两层,目录优先于向量检索,全部 Markdown 可 git 版本化。
阅读全文 (展开查看完整说明)
概述
📌 元数据
摘要:主记忆/经验/事实三层分离、目录优先检索的 agent 长期记忆系统;主记忆层含主人档案、关系定位与身份识别,边界限制升格为十类规范规则
标签:#AI #方法论 #记忆管理 #Agent记忆 #三层记忆
状态:🔍 待验证
权重:P1-常用
定位:本库唯一的「agent 长期记忆系统」落地技能。管记忆的分层结构、读写协议、事件串联、防丢失;不负责通用知识库的内容沉淀(走 kb-setup-skill),不负责向量数据库选型(走《向量数据库选型笔记》)。
技能简介
一句话:人格常驻、经验即用、事实可查;先认主人再看权限,目录找得到就不许动向量检索。
三层不是"摘要套摘要",而是按读取方式划分的三类东西:
| 层 | 目录 | 装什么 | 读取方式 | 变更频率 |
|---|---|---|---|---|
| L1 主记忆层 | main/ | 人格设定(我是谁 + 主人档案 + 我们的关系 + 身份识别)、规范规则(R1–R15)、记忆目录分深浅两层(深层 index.md 常驻 / 浅层 index-shallow.md 按需) | 每次会话必读(浅层不常驻) | 极低 |
| L2 经验记忆层 | experience/ | 实用方法论 SOP、常用问答模板 | 按任务定向命中即读 | 低 |
| L3 事实记忆层 | facts/ | 事件详情、知识详情、事件关联图 | 检索才读 | 高 |
v1.1 两处升级:① 人格里加了主人档案、关系定位、身份识别协议——agent 不只知道自己是谁,还知道主人是谁、怎么认出主人;② boundaries.md(边界限制)升格为 rules.md(规范规则),从"不能做什么"扩到十类规范(边界 / 隐私 / 身份权限 / 分层归属 / 写入 / 检索 / 串联 / 质量 / 维护 / 变更)。
v1.2 三处升级(让记忆库自己运转):① R11 自动触发——保存信号 T1–T11、读取信号 U1–U8,AI 不等指令就自己存取(用户说"记住"只是其中一种信号);② R12 留存分级——永久 / 长期 / 中期 / 会话态四级 + 四问判据,明确什么该长期记、什么不该入库;③ R13 常驻锚点——把记忆库指针注入 AGENTS.md 等常驻文件,让 AI 每次新会话都记得自己有记忆库,不再需要用户手动提醒"去查记忆"。
v1.3 升级(给常驻上下文瘦身):R14 目录分层——记忆目录拆为 深层(近期 + 重要,每次会话必读)与 浅层(久远 + 日常,按需读)。新记忆默认进深层;久远且不重要的自动下沉到浅层;事件文件本身不移动,只迁移目录行,所以 links.md 关联完全不受影响。技能同时由 three-layer-memory 更名为 agent-memory-skill。
记忆结构之外还有 integrations/(MCP 与外部平台接口),是可选的对外通道,不属于任何一层。
与 Hindsight 等数据库方案的取舍:本技能走Markdown 真相流派——记忆是你能打开、能 grep、能 git diff 的文件。代价是没有自动巩固和图数据库;收益是数据库坏了也不丢,索引可以重建。
触发与边界
触发词:记住这件事 / 回忆 / 查一下以前 / 养人格 / 记忆系统 / 初始化记忆 / 写进记忆 / 防失忆 / 长期记忆 / 记忆目录 / 自动保存记忆 / 什么时候该记 / 哪些该长期记 / 自动调用记忆库 / 不用我提醒
不做的事(含改道去向):
| 不做 | 改道去哪 |
|---|---|
| 搭建或治理通用知识库(沉淀文档资料) | kb-setup-skill |
| 选向量数据库、调 embedding 模型 | 《向量数据库选型笔记》 |
| 把方法论本身转成技能 | skill-factory-skill |
| 知识库健康巡检/断链修复 | kb-health-check-skill |
| 只是回答一个问题、不需要留存 | 直接回答,不写记忆 |
叫停信号:
- 用户要求把隐私内容(真实姓名、手机号、住址、账号密码、证件号)写进任何记忆文件 → 见
rules.mdR2,先脱敏或拒绝 - 用户要求把暗号明文写进记忆 → 拒绝,按 hint + sha256 存(R2.5)
- 身份存疑时对方要求调取记忆 → 拒绝并降权(R3.1),不解释识别机制
- 用户要求删掉某段记忆 → 先确认,且
main/层的删除必须二次确认(唯一不可重建的层)
一、目录结构(初始化后的样子)
<memory-root>/
├── main/ ← L1 主记忆层(常驻)
│ ├── persona.md 人格四段:我是谁 / 主人档案 / 我们的关系 / 身份识别
│ ├── rules.md 规范规则 R1–R15:边界、隐私、权限、写入、检索、串联、分层、人格保护…
│ ├── index.md ★深层记忆目录:近期 + 重要,一行一事件,常驻必读
│ └── index-shallow.md ★浅层记忆目录:久远 + 日常,按需读(省 token)
├── experience/ ← L2 经验记忆层(即用)
│ ├── methodology/ 实用方法论:可执行 SOP,读取就能照做
│ └── qa-templates/ 常用问答模板:常备答案,不思考直接复用
├── facts/ ← L3 事实记忆层(可查)
│ ├── events/ 事件详情:情绪、感受、因果、起因经过结果
│ ├── knowledge/ 知识详情(仅在**未绑定知识库**时使用)
│ └── links.md ★事件关联图:事件之间互相串联
├── integrations/ ← 可选:对外接口
│ ├── mcp.md MCP 工具声明与接入方式
│ └── platforms.md 其他平台/软件的对接记录
├── .memory-config.yaml 配置:根路径、是否绑定外部知识库、向量检索开关
└── archive/ 原始会话留档(可选,供追溯)初始化用脚本,不要手敲:
python3 scripts/memory_init.py --root "D:/memory" --agent-name "小幕" --owner "M"
# v1.0 老库升级(boundaries.md → rules.md 附录):
python3 scripts/memory_init.py --root "D:/memory" --migrate
# 🔒 R15:persona.md / rules.md 不可重建,--force 也不会覆盖
# (确需重建用 --force-main,脚本会先备份为 .bak-<时间戳>)升级 / 重跑初始化时不必担心人格被冲掉:main/ 下这两个不可重建文件已被硬保护(即使加了 --force)。
二、自动触发:让记忆库自己运转 ★v1.2 核心
完整信号表与正反例见
references/auto-trigger.md;留存分级见references/retention-spec.md。
记忆库不能靠指令驱动。 如果每次都要用户说"记住这个""去查一下记忆",90% 该记的会漏掉,用户自己也会忘了 AI 有记忆。所以读写必须由规则驱动:每轮对话扫描信号,扫到就做(R11)。
一句话目标:主人正常说话,我自动完成存取;主人不用管记忆库,但记忆库一直在运转。
2.1 保存触发 T1–T11(出现即自动写,不等指令)
| # | 信号 | 例子 | 自动动作 |
|---|---|---|---|
| T1 | 透露偏好 / 忌讳 | "我不喜欢长篇大论" | persona 主人段(需确认) |
| T2 | 纠正我 | "不对,应该先停服务" | 写事件 + 可复用则提 SOP |
| T3 | 达成决策 | 方案敲定、项目上线 | 写事件 |
| T4 | 强情绪 | 生气 / 兴奋 / 后悔 | 写事件,重点写感受与隐患 |
| T5 | 教方法 / 给模板 | "以后按这个格式写" | methodology(含验收标准) |
| T6 | 同一问题第 3 次 | 反复问同一流程 | qa-template(含适用边界) |
| T7 | 学到新知识 | "原来 X 是 Y" | 知识库 or facts/knowledge/ |
| T8 | 人物 / 关系 / 实体 | "我同事""XX 项目" | persona(确认)/ involves |
| T9 | 显式"记住" | "记住这件事" | 立即写入 |
| T10 | 会话收尾 | "先这样""今天到这" | 收尾三动作:盘点补漏 + 反思得失 + 一句话交接 → facts/events/(不需确认) |
| T11 | 踩坑 / 失败 | 方案行不通 | 事件 + "不要这样做" |
T10 收尾三动作(盘点 / 反思 / 交接)是防漏记、防断片的最后一道闸:长会话结束前主动回顾"这轮主人透露了什么偏好、做了什么决定、纠正了我什么"(盘点),再反思哪些记忆用上了 / 该记没记 / 已被推翻(反思),最后给下次会话留一句承接语(交接)。详见 auto-trigger.md 专节。
2.2 读取触发 U1–U8(出现即自动查,不等指令)
| # | 信号 | 自动动作 |
|---|---|---|
| U1 | 会话开始(无条件) | 先验身份 → 读 main/ 全量 |
| U2 | "上次 / 之前 / 那次 / 记得吗" | 检索 index → 详情 → 顺 links |
| U3 | 出现人名 / 项目名 / 日期 | 检索 index,命中即读 |
| U4 | "我是谁""你知道我吗" | 读 persona 第二、三段 |
| U5 | 同类任务 / 重复场景 | 扫 experience/ 标题,直接用 |
| U6 | "你怎么又忘了" | 先检索再回答,禁止辩解 |
| U7 | 要做决策 / 给建议 | 先读主人偏好 + 相关事件 |
| U8 | 情境与历史相似 | 主动联想提醒"上次你遇到类似情况时…" |
U6 的正确姿势:被说"你又忘了"时,第一反应是检索,不是道歉也不是反问。"没检索"和"没找到"是两回事。
U8 是记忆库真正的价值——前七个是被动作答,U8 是主人没问、你主动联想到。做不到 U8,记忆只是被存着,没被用起来。
2.3 每轮对话的自动判定流程
每轮对话
├─ ① 身份判定(R3)→ 存疑/非本人则本轮不读不写
├─ ② 扫读取触发 U1–U8 → 命中即检索(L0→L1→L2)
├─ ③ 正常回应 / 完成任务
├─ ④ 扫保存触发 T1–T11 → 命中即写入 + 更新 index/links + check
└─ ⑤ 会话收尾:T10 收尾三动作(盘点 / 反思 / 交接)自动保存只对 ✅ 确认的主人开放。存疑 / 非本人 / 接口进来的请求不自动写(防污染,R11.7)。
2.4 留存分级:什么该长期记(R12)
| 级别 | 标记 | 装什么 | 策略 |
|---|---|---|---|
| 🔴 永久 | —(天然) | persona.md、rules.md | 永不删,改需确认 |
| 🟠 长期 | retention: long | 重要事件、SOP、问答模板、已验证知识(默认) | 被推翻写新条目 + led_to,不删旧 |
| 🟡 中期 | retention: mid | 一般事件、阶段结论 | 可提炼进 L2 后归档 |
| ⚪ 会话态 | 不写 | 草稿、中间状态、闲聊、一次性问答 | 不入库 |
四问判据:① 一个月后还需要吗?② 会影响以后判断吗?③ 含不可替代信息吗(情绪/因果/亲身经历)?④ 会反复用到吗?——≥2 个"是" → 长期;全否 → 不写。
必写清单(不看四问):主人偏好、纠正、强情绪、关系信息、显式要求、核验失败、踩坑。不写清单:一次性问答、中间草稿、公开可查事实、纯闲聊、他人隐私。
2.5 常驻锚点:让 AI 永远记得这个库(R13)
所有规则都写在 rules.md 里——但规则文件本身也要被读到才有用。上下文一清空、新开会话,AI 若不知道自己有记忆库,就永远不会去读 rules.md,整套系统瞬间退化为无记忆。
做法:把一段「路径 + 必读时机 + 必写时机」的指针,注入 AI 每次会话必然加载的文件(AGENTS.md / CLAUDE.md / 工作区 MEMORY.md / .cursorrules):
python3 scripts/memory_anchor.py --root "D:/memory" --inject "AGENTS.md"
python3 scripts/memory_anchor.py --root "D:/memory" --check-all # 定期校验- 锚点只写「怎么用」,不写库里有什么(防泄露,R13.4)
- 幂等注入:不破坏目标文件原有内容,重复执行只替换不叠加
- 没做这一步 = AI 每次新会话都是失忆状态。
memory_check.py会报 W6 提醒;换项目 / 换工作区要重新注入
三、目录分层:深层与浅层 ★v1.3 核心
完整方案见
references/index-tiering.md,规则见rules.mdR14。
为什么分两层:记忆目录是常驻上下文的一部分,事件越多 token 越多。而大多数时候只需要近期的和重要的——三个月前的琐碎对话不该天天占着上下文。
深层 main/index.md | 浅层 main/index-shallow.md | |
|---|---|---|
| 装什么 | 近期(默认 90 天内)+ 重要(importance: high)+ 手动锁定(pinned: true) | 久远且不重要 |
| 读取 | 每次会话必读(L0 常驻) | 按需:深层没找到、且问题涉久远 / 小事时 |
| 新记忆 | 默认进深层 | 只接收下沉的旧条目 |
3.1 ★ 只动目录行,不动事件文件
facts/events/20250115-old-trivial.md ← 文件永远在这里,不移动
├─ 深层 index.md 里有这一行 → 常驻可见
└─ 浅层 index-shallow.md 里有这一行 → 按需可见
(同一时刻只能在一层,重复登记报 E6)这是本设计的关键:迁移的是入口不是内容。所以 links.md 关联、事件详情路径、git 历史全部不受影响,想恢复可见性改个字段 rebuild 即可。
3.2 怎么调整分层
python3 scripts/memory_tier.py --root <root> --plan # 看分层方案(不改)
python3 scripts/memory_tier.py --root <root> --stats # token 估算
python3 scripts/memory_tier.py --root <root> --pin <slug> # 🔒 锁定在深层,永不下沉
python3 scripts/memory_tier.py --root <root> --promote <slug> # ⭐ 标重要 → 拉回深层
python3 scripts/memory_tier.py --root <root> --demote <slug> # 标日常 → 立即下沉
python3 scripts/memory_tier.py --root <root> --heat # 🔥 按访问次数排,看谁常用
python3 scripts/memory_tier.py --root <root> --bump <slug> # 读完一个事件后自增其热度
python3 scripts/memory_index.py --root <root> --rebuild # ★ 改完必须重建才生效--plan 会标注每条留深层的原因(🔒 锁定 / ⭐ 重要 / 🕐 近期还剩几天),并预告 14 天内即将下沉的条目。
⚠️
--bump会改事件的 frontmatter(读取产生了写入)。建议按周期批量 bump 后一次git commit,别让 git 历史被"读过几次"刷满。
access_count写法要干净(access_count: 3),带行尾注释或中文也能容错读取,但会提示。
标签速览:深层事件 ≥30 条时,--rebuild 会在 index.md 自动追加一个按主标签分组的速览块,扫目录更快(<30 条自动移除,幂等;详见 index-tiering.md)。
3.3 在检索漏斗里的位置
L0 常驻 → persona + rules + 【深层 index.md】 ← 浅层不在这里
L1 定向 → 扫深层目录 → 命中直达事件 + links
L1.5 浅层 → 深层未命中 且 涉久远 / 小事 → 读【浅层 index-shallow.md】
L2 向量 → 两层都无 → 才动向量检索浅层是 L1 和 L2 之间的缓冲层:比向量检索便宜(读个文件而已),比直接说没找到靠谱(其实记得,只是不在常驻区)。
3.4 什么时候启用浅层
- 起步不用管:事件少时全在深层,浅层是空的
- 事件跨过几个月:
rebuild自动把老的不重要的沉下去,无需手动操作 - 深层超过 60 条:
memory_check.py报 W7,该整理了 - 时间窗不合手 → 改
.memory-config.yaml的deep_window_days(想让半年内都算近期就填 180)
token 账:每行目录摘要约 30 token。100 条事件全常驻 ≈ 3000 token;分层后若深层 40 条 ≈ 1200,省 60%。深层维持 30–60 条最舒服——该盯的是深层条数,不是天数。
四、读取协议(漏斗:常驻 → 深层 → 浅层 → 向量)★核心
顺序不可颠倒。上一级命中就不许动下一级。
| 级别 | 动作 | 成本 | 判据 |
|---|---|---|---|
| L0 常驻 | 会话开始先验身份,再无条件读 main/ 常驻三件:persona + rules + 深层 index.md(★浅层不常驻) | 固定,约 1–2K token | 无需判据,每次必读 |
| L1 定向 | 在深层 index.md 检索关键词 → 命中则读对应事件详情;再扫 experience/ 标题 | 极低 | 深层有匹配行,或 experience 有同名文件 |
| L1.5 浅层 | 深层未命中且问题涉久远 / 日常小事 → 读 index-shallow.md,并在回复中说明已查浅层 | 低 | 深层无匹配 + 问题指向久远或小事 |
| L2 向量检索 | 仅当 L0 + L1 + L1.5 都没找到,才对 facts/ 做向量检索,并明确记录目录未命中 | 高(要 embed、要算力) | 深层与浅层都无结果才进 |
为什么目录优先:记忆目录是人写的、带判断的索引,一行摘要往往比向量相似度更准;向量检索是兜底,不是首选。这条纪律直接省掉绝大多数无效检索。
L2 落地方式(本技能不绑定具体向量库):
- 轻量方案:
facts/全量文件用grep -r/ 关键词匹配兜底(小库足够) - 正式方案:接外部向量库(见
integrations/platforms.md),索引由facts/文件重建,索引损坏可随时memory_index.py --rebuild重建 - 铁律:向量索引永远是派生物,不是真相。删了能重建,就不算丢。
五、写入协议(分流判断树)★核心
新信息进来,按序判定落到哪层。每一步都要写出可观测产物。
新信息
├─ 是关于「我是谁 / 我该怎么说话 / 我的价值取向」?
│ → main/persona.md 第一段(极低频,改前必须向用户确认)
├─ 是关于「主人是谁 / 主人的偏好忌讳 / 我和主人的关系」?
│ → main/persona.md 第二、三段(同上,改前确认;不写真名)
├─ 是关于「怎么认出主人 / 暗号 / 权限分级」?
│ → main/persona.md 第四段(★暗号只存 hint + sha256,不写明文)
├─ 是关于「我不能做什么 / 隐私红线 / 各类规范标准」?
│ → main/rules.md 对应 R 编号(改前确认;改本文件需二次确认)
├─ 是一个「发生了的事件」?
│ → facts/events/YYYYMMDD-<slug>.md 写详情
│ + main/index.md 追加一行摘要(★必做,否则目录失效,这条记忆以后检索不到)
│ + facts/links.md 补关联(加分项,能判明因果时补;判不出可留白,孤岛非缺陷)
├─ 是从经历/学习中总结出的「可复用做法」?
│ → experience/methodology/<name>.md(写成 SOP,能被直接照做)
├─ 是「反复被问到的问题」且重要实用?
│ → experience/qa-templates/<name>.md
│ (★不重要、不实用的不进这层,直接回答即可)
└─ 是「学到的新知识」?
├─ 已绑定外部知识库 → 写进知识库,本记忆库只留一行指针
└─ 未绑定知识库 → facts/knowledge/<name>.md写入前三判(防重复,R5.9)
落到哪层之后、正式写文件之前,先过三判,避免库里长出重复 / 碎片记忆(借鉴 mem0 的 ADD/UPDATE/NOOP 思路,但本系统永不删除,矛盾走 led_to):
- 判重(NOOP):要写的内容与某条已有条目实质相同 → 不新建,只在原条目补一条关联 / 指针即可。
- 判补(合并):是已有条目的补充或新进展(同一件事,且未被推翻) → 在原条目上追加,不新建(避免碎片)。
- 判矛(矛盾 → led_to):与已有条目矛盾,且旧条目已被推翻 / 过时 → 写新条目,并用
led_to指向旧条目(沿用 R10.3 不删旧)。
三判都过不了"已有"的,才允许新建。这条把"不写重复"(R5)从清单变成了可执行的前置步骤。
每类写入的强制产出物:
| 写什么 | 强制产出物 | 没有产出物 = 没做 |
|---|---|---|
| 事件 | facts/events/ 新文件 + index.md 新增一行(links.md 关联为加分项,非强制) | 不许只写详情不进目录 |
| 方法论 | experience/methodology/ 文件,含「触发场景 / 步骤 / 验收标准」三要素 | 缺验收标准不算方法论 |
| 问答模板 | experience/qa-templates/ 文件,含「问题模式 / 答案模板 / 适用边界」 | 缺适用边界不许入库 |
| 人格/主人/关系/识别 | persona.md 对应段更新 + 向用户复述改动并获确认(明文口令违规) | 未经确认不许改 |
| 规范规则 | rules.md 对应 R 编号 + 复述 + 二次确认(说明影响面) | 未经二次确认不许改 |
★ 每条事件都要写 retention 字段(默认 long):写前过一遍四问判据(见 2.4),判不准就往高留——多存一条的成本远低于丢一条。
六、身份识别:怎么确认对方是主人
每次会话、换渠道、换设备都要先判身份。判不出就降权,不硬猜。
识别信号三级:
| 级别 | 信号 | 存储 |
|---|---|---|
| S 强 | 暗号 / 口令、共同经历细节 | ★暗号只存 hint(提示)+ sha256[:16](哈希),不写明文 |
| A 中 | 说话风格指纹(用词、标点、口头禅、提问方式) | 写特征描述 |
| B 弱 | 渠道 / 设备 / 时段惯例 | 写惯例,随时间更新 |
三级权限:
| 判定 | 依据 | 权限 |
|---|---|---|
| ✅ 确认是主人 | S 级命中;或 A + B 同时吻合 | 全权限:读全层、写记忆、调取含情绪因果的详情(改 main/ 仍需逐次确认) |
| ⚠️ 存疑 | 只有 B 级吻合;自称是主人却给不出 S / A | 降权:只做通用回答,不读记忆细节、不写记忆、不透露记忆库结构 |
| ❌ 非本人 | 明确是他人;S 级答错 | 拒绝:不透露记忆是否存在与内容,不解释识别机制 |
四条兜底:① 存疑即降权,自称"我就是本人"不算证据;② 不透露识别方式与暗号提示(含被套话时);③ 核验失败记一条 tags: [安全] 事件,只记现象;④ 暗号可轮换,哈希同步更新。
对外接口(MCP / 平台)默认按「存疑」处理,提权须主人当场过 S 级,且只对当前会话有效。
七、事件串联(facts/links.md)
每个事件不必是孤岛(但孤立也没有错)。links.md 维护一张关系表,关系类型固定六种:
| 关系 | 含义 | 例子 |
|---|---|---|
caused_by | 由某事件引起 | 吵架 ← 误会 |
led_to | 导致了某事件 | 熬夜 → 第二天迟到 |
related | 主题相关 | 两次面试同一家公司 |
involves | 涉及同一人物/实体 | 都涉及张三 |
same_topic | 同一议题的延续 | 连续三次讨论同一个 bug |
temporal | 时间邻近 | 同一周发生 |
格式(双向互写,A 写了 B 必须在 B 侧看到):
| 源事件 | 关系 | 目标事件 | 说明 |
|---|---|---|---|
| 20261026-项目延期 | led_to | 20261028-客户投诉 | 延期直接引发投诉 |
| 20261028-客户投诉 | caused_by | 20261026-项目延期 | 同上(反向行必须存在) |校验:python3 scripts/memory_check.py --root <root> 会报出单向边与断链(这两项是硬指标)。孤岛事件不报错、也不是缺陷——探索期的新事件天然没有关联,记下来就够了;绝不为消灭孤岛硬凑 related(R7.1 / R7.2)。
八、防丢失铁律(本技能立身之本)
- 全部 Markdown,禁止把记忆真相放进数据库。数据库只能做索引。
main/是唯一不可重建的层(人格、主人档案、关系、身份识别、规范规则都是人写的),必须单独备份;facts/和索引都能重建。- 记忆目录
index.md可由事件文件反向重建:python3 scripts/memory_index.py --rebuild,定期真跑一次验证,别等丢了才发现重建不了。 - 整个记忆根目录进 git,每次写入后提交,
git diff能看见人格是怎么变的。 - 压缩/清上下文不影响记忆:因为记忆在文件里。会话开始重新读
main/即可恢复,这是本方案的根本优势。
隐私红线(rules.md R2,写进去并强制遵守):
- 真实姓名、手机号、住址、身份证号、账号密码、密钥 → 默认不写;确需记录一律脱敏(如"张三"→"Z 先生")
- 用户明确要求"这条别记" → 立即不写,且不留任何摘要痕迹
- 涉及第三方隐私的内容 → 不写具体身份
九、执行流程
9.1 读取(命中读取信号 U1–U8 时自动执行)
- 先验身份:按第五节判定,存疑即降权(降权时不执行以下步骤,只通用回答)
- 读深层
main/index.md(L0/L1)——浅层此时不读 - 命中 → 读对应
facts/events/*.md详情,顺links.md找关联事件 - 未命中 → 扫
experience/标题 - 仍未命中且问题涉久远 / 小事 → 读浅层
main/index-shallow.md(L1.5),并在回复中说明已查浅层 - 仍无 → 转 L2 向量检索,并说明目录未命中
- 回答时必须标注来源文件路径,让用户可核对
9.2 写入(命中保存信号 T1–T11 时自动执行)
- 先验身份:非主人不写任何记忆
- 按「写入协议」判定层与文件,并定留存级别(四问判据,见 2.4)
- 若属
main/层 → 先复述改动向用户确认(改rules.md二次确认) - 写文件(用
assets/templates/对应模板,不手写格式) - 若属事件 → 同步更新
index.md与links.md - 跑
memory_check.py校验 - 提示用户
git commit
9.3 身份核验(怀疑对方不是主人)
- 抛
hint(提示,不给答案):「提示是:我们第一次一起做的事」 - 对方回答 → 取 sha256 前 16 位与
persona.md存的哈希比对 - 不一致 → 判存疑/非本人,按三级权限处置
- 记一条
tags: [安全]事件(只记现象,不记暗号内容与对方身份)
输出契约
必问清单(一次问完,≤8 问):① 记忆根目录放哪 ② agent 叫什么/什么人格 ③ 主人怎么称呼(代号,不写真名) ④ 你们是什么关系、相处基调 ⑤ 识别暗号(只收 hint + 哈希,不存明文) ⑥ 是否已绑定外部知识库(决定知识写哪) ⑦ 是否现在初始化并 git 化 ⑧ 常驻锚点注入到哪个文件(AGENTS.md / CLAUDE.md / 工作区 MEMORY.md——选你这个 agent 每次会话会自动加载的那个;漏了这步 AI 会失忆)(向量检索开关可默认先关,小库用 grep 兜底)
交付物:初始化完成的记忆目录(persona.md 四段 + rules.md R1–R15 + index.md)+ 常驻锚点已注入 + 本次写入/读取的结果 + 校验报告
完成证据:memory_check.py 通过(0 断链、index 与 events 一致、M2 persona 四段齐全、W6 锚点正常;孤岛事件不再视为错误)
放弃出口:用户拒绝提供根目录 / 内容属隐私红线 / 要求删除 main/ 且未二次确认 → 说明缺什么或直接停止,不硬造
停止条件
- 本次读写完成且校验通过
- 缺一个会改变结构的用户决定(如根目录、是否绑知识库)
- 内容命中隐私红线且用户坚持原文存储
- 用户只要方案或要求停止
资源导航
| 文件 | 内容 | 什么时候读 |
|---|---|---|
references/layer-spec.md | 三层的完整字段定义、persona 四段、写入标准、正反例 | 首次搭建 / 拿不准往哪层写时 |
references/rules-spec.md | R1–R15 完整条文、违反处置、新增规则方式 | 规则怎么执行 / 要加规则时 |
references/auto-trigger.md | 保存触发 T1–T11、读取触发 U1–U8、每轮判定流程、正反例、自检三问 | 每次会话前(直到内化) / 拿不准该不该存取时 |
references/retention-spec.md | 四级留存、四问判据、必写与不写清单、降级归档流程 | 拿不准该不该长期记时 |
references/index-tiering.md | 深浅目录方案、分层判据、token 账、常见错误 | 目录变长 / 拿不准某条在哪层时 |
references/retrieval-protocol.md | 漏斗详解(含浅层缓冲)、L2 向量检索接法、降级策略 | 检索结果不对、要接向量库时 |
references/linking-spec.md | 串联关系类型、links.md 规范、成网判据 | 写事件后补关联时 |
references/integration-mcp.md | MCP 工具声明、外部平台对接、接口清单 | 要对外暴露记忆能力时 |
references/anti-loss.md | 备份策略、重建演练、git 化、隐私红线细则 | 搭建完成后 / 定期体检 |
scripts/memory_init.py | 初始化目录骨架(含 --owner / --migrate;main/ 两文件 R15 硬保护) | 首次使用 / v1.0 升级 |
scripts/memory_index.py | 目录索引维护与重建(双层 + 标签速览) | 写事件后 / 定期 |
scripts/memory_check.py | 结构校验:单向边 / 断链 / 漏登记、index 一致、W6 锚点、W8 字段漂移 / W9 摘要重复 / W10 失效窗异常(孤岛仅提示,不算问题) | 每次写入后 |
scripts/memory_anchor.py | 常驻锚点:生成 / 注入 / 校验 / 移除(幂等) | 初始化后必做 / 换环境 / 定期体检 |
scripts/memory_tier.py | 目录分层管理:plan / stats / pin / promote / demote / heat(热度排序)/ bump(读后自增,建议批量后一次提交) | 整理目录 / 深层过长(W7)时 / 读完事件后 |
assets/templates/ | 五类文件模板(persona / rules / event / methodology / qa) | 写任何记忆文件时 |
🔗 知识关系(2026-10-26 建立)
关联(我指向谁):
- 使用:kb-setup-skill(外部知识库搭建技能)——元数据五要素、标签规范、文末关系段均沿用其规范
- 使用:标签库(受控标签 · 两族五维)——打标与功能标签新增登记规范
- 联想:知识库健康巡检技能——孤岛 / 断链检查思路同源
- 联想:向量数据库选型笔记——L2 向量检索落地时的选型依据
- 被联想:skill-factory-skill(技能工厂)——本技能按其产出流程设计
反向(谁指向我):
- 待建立:由 kb-setup-skill / 标签库 在下次维护时补写
📝 变更记录
- 2026-10-26:v1.0 创建。按 skill-factory-skill v1.2 七步流产出;三层结构、目录优先检索、事件串联、Markdown 防丢失四条设计均来自用户明确需求;元数据与关系段遵循 kb-setup-skill v6.0 §2/文末板块规范。
- 2026-10-26:v1.1 升级(用户明确需求)。①
persona.md由「我是谁」扩为四段:我是谁 / 关于我的主人 / 我们之间的关系 / 身份识别(S-A-B 三级信号、三级权限、四条兜底、暗号存 hint+sha256)。②main/boundaries.md升格为main/rules.md:R1 行为边界、R2 隐私安全、R3 身份权限、R4 分层归属、R5 写入、R6 检索、R7 串联、R8 质量、R9 维护、R10 变更。③ 脚本:memory_init.py改读模板、支持--owner/--migrate;memory_check.py新增 M1 缺主记忆文件、M2 persona 缺段、W3 明文口令、W4 规则缺失、W5 旧 boundaries 遗留。④ 冒烟:init → 5 事件(含 1 条安全事件)→ rebuild → check = 0 error / 0 warning;负例(缺 rules / 明文口令 / 旧 boundaries)均被正确报出。 - 2026-10-26:v1.2 升级(用户明确需求:让 AI 自动存取记忆、并长期记住自己有记忆库)。①
rules.md由 R1–R10 扩到 R1–R13:R11 自动触发(保存 T1–T11 / 读取 U1–U8 / 每轮判定流程 / 只对确认主人开放)、R12 留存分级(永久·长期·中期·会话态 + 四问判据 + 必写不写清单 + 降级归档)、R13 常驻锚点(注入 / 校验 / 换环境重注 / 不写库内容)。② 新增references/auto-trigger.md、references/retention-spec.md。③ 新增assets/templates/memory-anchor.md与scripts/memory_anchor.py(--inject/--check/--check-all/--remove/--print,幂等且不破坏目标文件原内容)。④memory_init.py加--anchor-target(可多次)与auto_trigger/session_wrapup_scan配置;memory_check.py加 W6 锚点校验、R 编号检查扩到 R13。⑤ 冒烟:init(含锚点注入)→ 2 事件(含retention字段)→ rebuild → check = 0 error / 0 warning;负例(锚点被覆盖丢失)正确报 W6、重新注入即恢复;重复注入不叠加(START 标记恒为 1)。 - 2026-10-26:v1.3 升级(用户明确需求:给常驻上下文瘦身)。① 记忆目录拆为深浅两层:深层
main/index.md(近期 + 重要,常驻必读)、浅层main/index-shallow.md(久远 + 日常,按需读);新事件默认进深层,久远(超deep_window_days,默认 90 天)且不重要的在 rebuild 时自动下沉;★事件文件不移动,只迁移目录行,故links.md关联完全不受影响。② 新增 R14 目录分层规范(7 条)、references/index-tiering.md、scripts/memory_tier.py(plan / stats / pin / unpin / promote / demote);事件模板新增importance与pinned字段。③ 检索漏斗由三级扩为四级:L0 常驻 → L1 深层 → L1.5 浅层 → L2 向量。④ 脚本:memory_index.py支持双层 rebuild 与--stats;memory_check.py的 E4 改为跨两层统计,新增 E6 重复登记、W7 深层过长;memory_init.py生成index-shallow.md与deep_window_days配置。⑤ 技能由three-layer-memory更名为agent-memory-skill(中文名:Agent 记忆系统技能)。⑥ 冒烟:3 事件(近期 / 久远普通 / 久远重要)→ rebuild 自动分层为深层 2 + 浅层 1;--demote下沉、--promote拉回均生效;check = 0 error。 - 2026-10-27:v1.3.3 升级(对标 GitHub 同类项目拆解后的定向吸收;原则=只优化原有功能、不新增功能、只吸收有用的、不硬凑)。① 写入前三判 R5.9(借鉴 mem0 ADD/UPDATE/NOOP,但本系统永不删除):正式写文件前先判「重(NOOP)/补(合并)/矛(矛盾→
led_to)」,把"不写重复"从清单变成可执行前置步骤;同步进rules-spec.md与assets/templates/rules.md。② 失效窗invalidated_by(借鉴 Zep 双时间轴):被推翻的旧事件加显式失效标记,让"演变"可见可判定;配led_to双向表达;memory_check.py新增 W10 校验其指向与时间逻辑;文档见retention-spec.md「六之二」。③ 热度分层(借鉴 MemoryOS 热度分):事件加access_count/last_access,memory_tier.py新增--heat(按访问排序)与--bump(读后自增),让常用旧事可凭热度--promote回深层;★仅作建议不自动改层。④ T10 收尾三动作(借鉴 robabby reflect/pickup):收尾由"盘点补漏"扩为 盘点 / 反思 / 交接,防漏记也防断片;见auto-trigger.md专节。⑤ 深层标签速览(借鉴 MemoryOS 分段):memory_index.py --rebuild在深层 ≥30 条时自动追加按主标签分组的AUTO:tags块(<30 自动移除),加速扫描。⑥ schema 漂移检查:memory_check.py新增 W8(缺retention/importance)、W9(摘要重复)、W10(失效窗异常),均 warning 不阻断。⑦ MCP 工具标注:integration-mcp.md工具表加「副作用 / 幂等」列,接入方据此判断风险。⑧ 锚点补 L0 必读清单 + token 预算(借鉴 Letta 字符预算):memory-anchor.md明确三件套常驻约 1–2K token,并顺手修正锚点里陈旧的R1–R13→R1–R15。⑨ git 提交钩子:anti-loss.md新增.git/hooks/pre-commit自动跑memory_check.py,有 error 即阻断提交。⑩ 未吸收项(明确排除):F5 检索、F7 串联、F12 经验层、写入回执——均为用户判定"不改",保持现有设计。 - 2026-10-27:v1.3.4 升级(全库通读后的纠错与做实;原则=修缺陷、不加功能、不改结构、不硬凑)。① 🔴 修
--force抹掉人格(P0 安全缺陷):memory_init.py原先os.path.exists and not force会让--force把persona.md/rules.md覆盖成空模板——而 R15.5 白纸黑字写着"绝不覆盖",代码与承诺相反。现新增PROTECTED硬保护:这两个文件任何情况下都不被--force覆盖;确需重建须显式--force-main,且脚本先自动备份为.bak-<时间戳>(可回滚)。② 统一「孤岛」口径(5 处残留):layer-spec.md「必须关联否则校验会报」、SKILL.md写入树「★必做否则成孤岛」、「会报出孤岛事件」、retention-spec.md归档检查、README体检描述——全部与 R7.1 打架,会让 AI 为消灭孤岛硬凑related(恰是 R7.2 禁止的)。现全库统一:关联是加分项、孤岛非缺陷、index.md加行才是必做。③ 修 T10 表格错位:SKILL.md 保存触发表表头 4 列而 T10 行 6 列,整表渲染错位(v1.3.3 升级时引入),已改回 4 列;并全表扫描确认 0 处错位。④ E4 改集合比对(P1):原 E4 只比行数,实测「某事件漏登记 + 另一事件重复登记」时行数互补、check 仍判"一致"——这条记忆从此检索不到却无人知晓,而 R5.4 说"不进目录 = 没写"。现比对文件名集合,分别报「漏登记」「登记了不存在的事件」「重复登记」。⑤ E3 覆盖目录「关联方法」列:原 E3 只扫links.md边与事件内关联段,目录 method 列链接(方法论改名后)静默失效无人查,现计入断链。⑥--heat/--bump容错(P1):access_count: 3 # 注释会让命令ValueError直接崩,现取前导数字、失败按 0 并提示;同时文档明确--bump会改事件文件,建议批量后一次提交,避免 git 被"读"刷满。⑦ 文案对齐:R1–R14→R1–R15(4 处)、三级漏斗→四级、盘点补漏→收尾三动作(5 处)、≤7 问→≤8 问(实列 8 项)、README 标题与文件清单同步。⑧ event 模板补led_to字段位:retention-spec六之二要求新事件用 frontmatterled_to表达推翻关系,但模板没给位置,现与invalidated_by成对补上。⑨ 冒烟:--force后自定义人格与自定义规则均完好(count 1);--force-main备份文件可找回原内容;负例(漏登记 / 指向已删文件 / 方法列断链)三条全部被拦下;脏access_count(行尾注释 / 中文 / 空)四种写法--heat/--bump均正常退出且提示到位。