---
created: 2026-04-20
title: WorkBuddy 记忆系统使用指南
tags: [笔记方法, 记忆系统, WorkBuddy, 项目管理]
source: 本项目实践总结
---

# WorkBuddy 记忆系统使用指南

> 以「教育AI研究」项目为实例，记录记忆系统的架构设计与使用方法。
> 适用版本：WorkBuddy + Obsidian（vault：kepano-obsidian-main）

---

## 一、项目类型定位

**研究写作型项目** — 核心产出是报告/论文/档案，不是代码调试。

这决定了记忆系统的设计逻辑：

- **三层架构** 而非两套并行记录
- **追加写入** 而非覆盖更新
- **产出驱动** 而非时间驱动
- **错误即记** 而非事后汇总

---

## 二、三层记忆架构

### 第一层：每日工作日志（Append-only）

**文件**：`raw/教育AI研究/.workbuddy/memory/YYYY-MM-DD.md`

**规则**：每次实质性工作后**追加**一条新记录，不覆盖旧内容。

```
结构：
## 任务名完成

### 新增产出
- [产出1]
- [产出2]

### 核心发现
1. 发现A
2. 发现B
---
```

**特点**：按时间顺序累积，历史可追溯；重在"今天做了什么"，不在"项目全景"。

---

### 第二层：项目长期记忆（Update-in-place）

**文件**：`raw/教育AI研究/.workbuddy/memory/MEMORY.md`

**规则**：对项目有长期价值的知识（统计数据、模板路径、关键发现）**直接更新**对应章节，不累积日志。

**必须包含的内容**：

| 内容 | 示例 |
|------|-------|
| 项目基本信息 | 路径、目标、启动时间 |
| 笔记规范 | `created:` vs `date:` 等字段约定 |
| 核心发现 | 关键数据、对比结论、政策教训 |
| 模板工具 | 报告模板、自动化配置位置 |
| 产出统计 | 档案X家、报告Y份 |
| 错误规律 | 曾犯错误、数据失实案例 |

**禁止**：把每日流水账写进 MEMORY.md；数字与实际文件数不一致；过时内容不清理。

---

### 第三层：自我改进日志（Append-only）

**文件**：`raw/教育AI研究/.workbuddy/.learnings/`

| 文件 | 触发条件 |
|------|----------|
| `ERRORS.md` | 命令/API/下载失败 |
| `LEARNINGS.md` | 发现更好方案，知识缺口 |
| `FEATURE_REQUESTS.md` | 用户想要但缺失的功能 |

**格式**：每条记录带 ID（`[ERR-YYYYMMDD-XXX]`）、优先级、状态、Pattern-Key。

**晋升规则**：同一 Pattern-Key 出现 ≥3 次 → 提炼写入 MEMORY.md

---

## 三、记忆更新四步检查（每次对话结束前强制执行）

```
1️⃣ 产出统计
   扫描 raw/教育AI研究/机构档案/、raw/教育AI研究/深度研究报告/ 目录，统计新增文件数
   → 更新 MEMORY.md 累计数字

2️⃣ 错误记录
   本对话中遇到任何失败（下载/API/命令）
   → 追加到 .learnings/ERRORS.md

3️⃣ 洞察归档
   本对话发现的重要新知识
   → 判断是否写入 MEMORY.md 对应章节

4️⃣ 汇报输出
   向用户简要汇报本次记忆更新情况
```

---

## 四、Obsidian 笔记规范（必须遵守）

### Frontmatter 字段

```yaml
---
created: YYYY-MM-DD    # ✅ 日期字段统一使用 created
title: 笔记标题
tags: [tag1, tag2]
source: 来源URL
---
```

⚠️ **禁止**使用 `date:` 字段

### vault 路径规范

| 类型 | 路径 |
|------|------|
| 本项目工作区 | `raw/教育AI研究/` |
| Clippings 剪藏 | `Clippings/` |
| OpenMAIC 笔记 | `raw/教育AI研究/` 子目录 |
| 记忆文件 | `raw/教育AI研究/.workbuddy/memory/` |

---

## 五、以「教育AI研究」项目为例的实际结构

```
kepano-obsidian-main（vault根目录）
└── raw/
    └── 教育AI研究/
        └── .workbuddy/
            ├── memory/
            │   ├── MEMORY.md              ← 项目百科名片（长期记忆）
            │   └── 2026-04-20.md        ← 今日工作日志（追加）
            ├── automations/                ← TOML 自动化配置
            │   ├── 周计划.toml
            │   ├── 周报.toml
            │   └── 月末回顾.toml
            └── .learnings/                ← 错误/学习/需求记录
                ├── ERRORS.md
                ├── LEARNINGS.md
                └── FEATURE_REQUESTS.md
```

---

## 六、常见错误与避免方法

| 错误 | 后果 | 避免方法 |
|------|------|----------|
| MEMORY.md 数字与实际不符 | 误导后续判断 | 每次更新前扫描目录确认 |
| 把流水账写进 MEMORY.md | 文件膨胀、难以阅读 | 只写长期知识，不写过程记录 |
| 错误不记录 | 重复踩坑 | 失败后立即记入 ERRORS.md |
| 跨日期覆盖日志 | 历史丢失 | 只追加，不覆盖 |
| 发现新知识不归档 | 经验流失 | 判断是否入 MEMORY.md |

---

## 七、与其他工具的配合

| 工具 | 用途 |
|------|------|
| obsidian-cli | 搜索/创建/编辑笔记文件 |
| obsidian-markdown | 格式化 OFM 语法 |
| obsidian-bases | 数据库视图管理 |
| paper-search | 论文检索与下载 |

---

## 八、给 AI 助手的系统提示（供 WorkBuddy 参考）

```
这是一个研究写作型项目。
记忆更新规则：每次对话结束前必须执行四步检查。
禁止：只回复总结不更新记忆文件，数字与实际不符。
产出统计 → 更新 MEMORY.md 计数
失败错误 → 写入 .learnings/ERRORS.md
重要发现 → 写入 MEMORY.md 对应章节
新需求 → 写入 .learnings/FEATURE_REQUESTS.md
```

---

> 本笔记作为记忆系统的使用手册，新开项目时可参考此模板初始化。