name

memory-layers

description

五层记忆法 — 将经历转化为持续增长的智慧系统。触发条件：用户说"沉淀"、"总结经验"、"提炼模式"、"建立原则"，或需要将事件→经验→模式→原则→身份逐层升华时调用。不要在用户只要求"记一下"时触发 — 必须是明确的知识升华意图。 **自动触发**：每次对话结束时自动检查是否有值得沉淀的内容，有则自动提炼保存。

Memory Layers — 五层记忆法

把每一次经历，变成持续增值的智慧资产。

首次使用配置

新用户首次使用时，询问：

请告诉我你要存放记忆的文件夹路径，例如：~/记忆库 或 ~/Desktop/我的记忆

（这个文件夹会由系统自动创建，你只需确认好保存位置、同时给它起个名字）

其余全部用默认值，无需询问：

提醒周期：L1→L2: 7天，L2→L3: 14天，L3→L4: 30天，L2回看: 30天
引用阈值：5次（达到此次数时 AI 会通知你准备生成新 skill）
脚本目录：内嵌在 skill 里，你无感知

将配置写入 vault 的 .config.json，后续自动读取。

核心配置

配置项	说明	默认值
`vault_path`	记忆 vault 路径	用户提供
`scripts_path`	搜索脚本目录	用户提供
`ref_threshold`	触发 skill 生成的引用次数	5
`reminder_days.L1-L2`	L1→L2 提醒周期	7 天
`reminder_days.L2-L3`	L2→L3 提醒周期	14 天
`reminder_days.L3-L4`	L3→L4 提醒周期	30 天
`reminder_days.L2-review`	L2 回看周期	30 天

五层结构

层次	名称	问题	输出
L1	事件层	发生了什么？	原始记录
L2	经验层	学到了什么？	教训与洞察
L3	模式层	有什么规律？	跨事件模式
L4	原则层	指导原则是什么？	行动准则
L5	身份层	我是谁？	核心身份定位

核心理念：知识必须被编译一次，然后持续维护。不是每次重新推导，而是逐层升华。

自动触发规则

何时触发沉淀

以下情况自动触发沉淀（无需用户要求）：

对话结束时：发现用户做了重要决策、踩了坑、有突破性洞察
任务完成后：成功或失败，都值得记录
模式识别时：发现当前事件与历史模式有共鸣
原则冲突时：实践中发现原有原则不适用

触发判断

用户明确说了"沉淀"、"总结" → 直接走 distill
用户只是闲聊 → 不触发
重要判断：拿不准是否值得沉淀时，默认沉淀（宁可多，不可漏）

工作流路由

用户意图关键词	工作流
"五层沉淀"、"逐层提炼"、"完整走一遍"	→ distill
"发生了什么"、"事件记录"、"记一下"	→ record-event
"从事件提炼经验"、"从经验找规律"	→ ascend
"检查记忆系统"、"健康检查"、"现状如何"	→ status
"生成记忆报告"、"给我讲讲我的模式"	→ report
（无关键词，对话中有值得沉淀的内容）	→ auto-distill

执行约束（红线）

禁止跳过层次：L2 经验不能凭空产生，必须有具体事件支撑
禁止放之四海而准：每条原则必须有来源事件或模式支撑
禁止一次性完成：五层是持续迭代的系统，不是一次性写作
禁止脱离具体上下文：原则必须绑定到具体领域/场景
禁止 L4 原则复述 L3 模式：原则必须比模式更具体、更有可操作性
禁止不保存：识别到值得沉淀的内容，必须写入 vault，不能只存在上下文里
禁止不索引：每次保存后自动索引到 FTS5 数据库

FTS5 搜索系统

搜索脚本: {scripts_path}/memory-layers-search.sh 索引脚本: {scripts_path}/memory-layers-index.sh 数据库: {vault_path}/search/memory-search.db

使用方式

# 搜索记忆
memory-layers-search.sh "压力 决策"

# 自动索引（在 distill 完成后调用）
memory-layers-index.sh L2 "决策教训" "在压力下做了X决策..." "layers/L2-experiences/xxx.md" "2026-04-10"

技能自生成机制

触发阈值：被引用 N 次时（N 可配置，默认 5 次），自动生成可调用 skill

技能形态（待具体讨论）：

用户可用：行动清单、检查清单
AI 可用：可复用的 Agent skill，可在未来任务中调用

引用追踪（自动）：

每次 L3 模式或 L4 原则被调用/引用时，自动更新计数
达到阈值时，自动告知用户：准备生成新 skill

提醒机制

升华路径	提醒周期
L1→L2	7 天后回看，验证经验是否成立
L2→L3	14 天后，验证模式是否被新事件支持
L3→L4	自动提炼，无需等待
L2 经验回看	30 天后复盘，是否有新的理解

提醒触发：每次对话结束时检查是否有到期提醒，主动告知用户。

vault 标准目录结构

vault/
├── CLAUDE.md
├── .config.json
├── layers/
│   ├── L1-events/
│   ├── L2-experiences/
│   ├── L3-patterns/
│   ├── L4-principles/
│   ├── L5-identity/
│   └── .index.json
├── skills/
├── search/
│   └── memory-search.db
├── reminders/
│   ├── config.json
│   ├── pending/
│   └── done/
└── inbox/

工作流索引

工作流	文件
setup（首次配置）	`workflows/setup.md`
distill（完整五层沉淀）	`workflows/distill.md`
record-event（事件记录）	`workflows/record-event.md`
ascend（层级升华）	`workflows/ascend.md`
status（现状检查）	`workflows/status.md`
report（记忆报告）	`workflows/report.md`
auto-distill（自动沉淀）	`workflows/auto-distill.md`