hehaiguang1123
a6f05ab2d5
- Phase 0: AGENTS.md cleanup (dedup quotes, renumber sections, merge qmd) - Phase 1: typed relations (manage-relations.py, graph-search.py, check-staleness.py, detect-conflicts.py) - Phase 2: frontmatter validator, weekly lint, knowledge promotion, git hooks - Fix .gitignore to track tools/ and .githooks/ - Fix git remote URL (remove plaintext token) - New wiki pages: 504 pages, 34 raw sources
198 lines
5.5 KiB
Markdown
198 lines
5.5 KiB
Markdown
---
|
||
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
|
||
```
|
||
|
||
---
|
||
|
||
> 本笔记作为记忆系统的使用手册，新开项目时可参考此模板初始化。
|