agent-memory-skill
/agent-memory-skill
Prowadzi system pamięci agenta: zapisuje i odczytuje wspomnienia na żądanie, dba o osobowość, zasady i poziomy przechowywania w plikach Markdown.
- Autor
- syc-dspyy ↗
- Repozytorium
- agent-memory-skill ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 28.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 4
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 28.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Prowadzi system pamięci agenta: zapisuje i odczytuje wspomnienia na żądanie, dba o osobowość, zasady i poziomy przechowywania w plikach Markdown.
Oryginalny opis (EN)
Agent 记忆系统技能。当用户要求「记住这件事」「回忆/查记忆」「养 agent 人格」「配置记忆系统」「初始化记忆目录」「写记忆」「防失忆」「给 agent 加长期记忆」「记住我是谁/怎么认出我」「给 agent 定规矩」「让 AI 自动保存/自动读取记忆」「什么时候该记下来」「哪些记忆该长期留」「不用我提醒就自动调用记忆库」时使用。人格层含主人档案、关系定位与身份识别(暗号 hint+哈希、三级权限);规范规则 rules.md 含 R11 自动触发(保存信号 T1–T11 / 读取信号 U1–U8)、R12 留存分级(永久/长期/中期/会话态)、R13 常驻锚点(让 AI 永远记得自己有记忆库)、R14 目录分层(深层存近期与重要、浅层存久远日常,省 token);R15 人格设定保护(安装绝不覆盖用户既有设定,脚本层已硬保护,`main/` 两文件 `--force` 也不覆盖)。人格、经验、事实分三层,记忆目录再分深浅两层,目录优先于向量检索,全部 Markdown 可 git 版本化。
Jak działa
- 技能简介
- 触发与边界
- 一、目录结构(初始化后的样子)
- 二、自动触发:让记忆库自己运转 ★v1.2 核心
- 三、目录分层:深层与浅层 ★v1.3 核心
- 四、读取协议(漏斗:常驻 → 深层 → 浅层 → 向量)★核心
- 五、写入协议(分流判断树)★核心
- 六、身份识别:怎么确认对方是主人
- 七、事件串联(facts/links.md)
- 八、防丢失铁律(本技能立身之本)
Podgląd SKILL.md
---
name: agent-memory-skill
slug: agent-memory-skill
version: 1.3.4
displayName: Agent 记忆系统技能
description: Agent 记忆系统技能。当用户要求「记住这件事」「回忆/查记忆」「养 agent 人格」「配置记忆系统」「初始化记忆目录」「写记忆」「防失忆」「给 agent 加长期记忆」「记住我是谁/怎么认出我」「给 agent 定规矩」「让 AI 自动保存/自动读取记忆」「什么时候该记下来」「哪些记忆该长期留」「不用我提醒就自动调用记忆库」时使用。人格层含主人档案、关系定位与身份识别(暗号 hint+哈希、三级权限);规范规则 rules.md 含 R11 自动触发(保存信号 T1–T11 / 读取信号 U1–U8)、R12 留存分级(永久/长期/中期/会话态)、R13 常驻锚点(让 AI 永远记得自己有记忆库)、R14 目录分层(深层存近期与重要、浅层存久远日常,省 token);R15 人格设定保护(安装绝不覆盖用户既有设定,脚本层已硬保护,`main/` 两文件 `--force` 也不覆盖)。人格、经验、事实分三层,记忆目录再分深浅两层,目录优先于向量检索,全部 Markdown 可 git 版本化。
---
# agent-memory-skill・Agent 记忆系统技能 v1.3.4
> 📌 元数据
> 摘要:主记忆/经验/事实三层分离、目录优先检索的 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.md` R2,先脱敏或拒绝
- 用户要求把暗号明文写进记忆 → 拒绝,按 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/ 原始会话留档(可选,供追溯)
```
初始化用脚本,不要手敲:
```bash
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`):
```bash
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.md` **R14**。
**为什么分两层**:记忆目录是常驻上下文的一部分,事件越多 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 怎么调整分层
```bash
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`):
1. **判重(NOOP)**:要写的内容与某条已有条目**实质相同** → 不新建,只在原条目补一条关联 / 指针即可。
2. **判补(合并)**:是已有条目的**补充或新进展**(同一件事,且未被推翻) → 在原条目上追加,不新建(避免碎片)。
3. **判矛(矛盾 → 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 侧看到):
```markdown
| 源事件 | 关系 | 目标事件 | 说明 |
|---|---|---|---|
| 20261026-项目延期 | led_to | 20261028-客户投诉 | 延期直接引发投诉 |
| 20261028-客户投诉 | caused_by | 20261026-项目延期 | 同上(反向行必须存在) |
```
校验:`python3 scripts/memory_check.py --root <root>` 会报出**单向边**与**断链**(这两项是硬指标)。
**孤岛事件不报错、也不是缺陷**——探索期的新事件天然没有关联,记下来就够了;绝不为消灭孤岛硬凑 `related`(R7.1 / R7.2)。
---
## 八、防丢失铁律(本技能立身之本)
1. **全部 Markdown,禁止把记忆真相放进数据库**。数据库只能做索引。
2. **`main/` 是唯一不可重建的层**(人格、主人档案、关系、身份识别、规范规则都是人写的),必须单独备份;`facts/` 和索引都能重建。
3. **记忆目录 `index.md` 可由事件文件反向重建**:`python3 scripts/memory_index.py --rebuild`,定期真跑一次验证,别等丢了才发现重建不了。
4. **整个记忆根目录进 git**,每次写入后提交,`git diff` 能看见人格是怎么变的。
5. **压缩/清上下文不影响记忆**:因为记忆在文件里。会话开始重新读 `main/` 即可恢复,这是本方案的根本优势。
**隐私红线**(`rules.md` R2,写进去并强制遵守):
- 真实姓名、手机号、住址、身份证号、账号密码、密钥 → **默认不写**;确需记录一律脱敏(如"张三"→"Z 先生")
- 用户明确要求"这条别记" → 立即不写,且不留任何摘要痕迹
- 涉及第三方隐私的内容 → 不写具体身份
---
## 九、执行流程
### 9.1 读取(命中读取信号 U1–U8 时自动执行)
0. **先验身份**:按第五节判定,存疑即降权(降权时不执行以下步骤,只通用回答)
1. 读**深层** `main/index.md`(L0/L1)——浅层此时**不读**
2. 命中 → 读对应 `facts/events/*.md` 详情,顺 `links.md` 找关联事件
3. 未命中 → 扫 `experience/` 标题
4. 仍未命中**且问题涉久远 / 小事** → 读浅层 `main/index-shallow.md`(L1.5),并在回复中说明已查浅层
5. 仍无 → 转 L2 向量检索,并说明目录未命中
6. 回答时**必须标注来源文件路径**,让用户可核对
### 9.2 写入(命中保存信号 T1–T11 时自动执行)
0. **先验身份**:非主人不写任何记忆
1. 按「写入协议」判定层与文件,并定留存级别(四问判据,见 2.4)
2. 若属 `main/` 层 → 先复述改动向用户确认(改 `rules.md` 二次确认)
3. 写文件(用 `assets/templates/` 对应模板,不手写格式)
4. 若属事件 → 同步更新 `index.md` 与 `links.md`
5. 跑 `memory_check.py` 校验
6. 提示用户 `git commit`
### 9.3 身份核验(怀疑对方不是主人)
1. 抛 `hint`(提示,不给答案):「提示是:我们第一次一起做的事」
2. 对方回答 → 取 sha256 前 16 位与 `persona.md` 存的哈希比对
3. 不一致 → 判存疑/非本人,按三级权限处置
4. 记一条 `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` 六之二要求新事件用 frontmatter `led_to` 表达推翻关系,但模板没给位置,现与 `invalidated_by` 成对补上。⑨ 冒烟:`--force` 后自定义人格与自定义规则均完好(count 1);`--force-main` 备份文件可找回原内容;负例(漏登记 / 指向已删文件 / 方法列断链)三条全部被拦下;脏 `access_count`(行尾注释 / 中文 / 空)四种写法 `--heat`/`--bump` 均正常退出且提示到位。
Pliki w paczce (4)
- .gitignore 1 KB
- LICENSE 1 KB
- README.md 17 KB
- SKILL.md 40 KB
Wersje
W bazie nie ma innych skilli o nazwie agent-memory-skill.
Migawka bazy z 13.11.2026 · wersja paczki 8f3316764bc4 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100create-agent
Prowadzi przez zdefiniowanie własnego agenta w przestrzeni roboczej: nazwa, domena, osobowość, umiejętności, model i folder pamięci. - 90memory-system
Projektuje, wdraża lub ocenia system pamięci użytkownika dla agenta: formaty przechowywania, Mem0, Memobase, kompresję i prywatność. - 100build-memory
Buduje, odświeża i uczy pamięć agenta Aicoo na podstawie rzeczywistego kontekstu użytkownika: plików, repozytorium, historii git, dokumentów oraz pamięci Claude i innych agentów. - 100linglu-discipline
Wprowadza zasady pracy i obsługi pamięci w projekcie Lingshu, ładowane na starcie sesji lub przy zapisie pamięci, poleceniach, commitach, analizie przyczyn i danych wrażliwych. - 100audit-memory
Sprawdza pliki reguł i pamięci agenta, np. CLAUDE.md i AGENTS.md, pod kątem nieaktualnych lub sprzecznych linii. - 90review-agent-memory
Sprawdza poprawność konfiguracji pamięci agentów i magazynu stanu, na prośbę o audyt trwałości agentów.