WorkBuddy 的记忆机制远比表面复杂，三层记忆加人格层文件，让 AI 真正懂你、懂项目。本文从目录结构到优先级冲突，用 B 端实战案例拆解如何高效“喂”记忆，助你告别重复交代，让 AI 成为得力助手。

官方文档关于记忆讲得比较抽象，很多朋友用了很久，其实没搞清楚记忆到底怎么运作、该怎么”喂”。本文就从头给你捋一遍。

本文讲6块内容：

一、三层记忆基础：WorkBuddy到底有几层记忆

我花了不少时间研究WorkBuddy的记忆机制——翻文档、看本地目录、一个个文件打开试。结论是：WorkBuddy的记忆分3层，外加一个会话上下文（第0层，关窗就没）。

三层记忆分别是什么

第一层：云端画像（自动）

WorkBuddy会自动从你的对话中抽取长期信息——你的职业、城市、语言偏好、工作习惯等。这些内容存在云端，每次新对话自动注入，不用你管。

每次会话结束后，系统会在夜间（具体时间不详）批量整理对话内容，把稳定的事实沉淀到画像里。聊得越多，画像越准。

本地有个缓存文件：C:Users你的用户名.workbuddymemory{uuid}_memory.md，但这只是云端内容的镜像，不要直接改它——下次同步会把你改的冲掉。要看或编辑云端画像，去”设置→记忆”里操作。

第二层：用户级本地记忆（手动，跨项目）

路径：C:Users你的用户名.workbuddyMEMORY.md

你手动写的跨项目通用规则。比如”输出用Markdown””流程图用Mermaid”——所有项目都生效。

项目专属的东西别放这里，不然到别的项目也会被错误继承。

第三层：工作区级记忆（手动或AI，项目专属）

路径：你的项目目录.workbuddymemoryMEMORY.md

每个项目独立的记忆空间。你在A项目写的规则，B项目看不到。

除了手动写，WorkBuddy完成任务后也会自动往每日日志（YYYY-MM-DD.md）里追加当日工作记录。但日志是过程记录，想长期生效的规则必须写到MEMORY.md里。

加上第0层：会话上下文

就是当前对话窗口里的内容。关窗即失，但在本轮对话内优先级最高。

记忆优先级

从高到低：

会话上下文 > 工作区级记忆 > 用户级记忆 > 云端画像

核心原则就一句：越近、越具体，优先级越高。

怎么”喂”记忆

B端PM实战案例——工作区级记忆长什么样：

以电商供应链项目为例：

## 项目业务规则

– 订单状态机：待支付→已支付→已发货→已签收→已完成，超时未支付自动取消

– 字段命名规范：SKU编号统一使用sku_code，不用sku_no或sku_number

– 退款逻辑：已发货订单不支持整单退款，只能逐个商品退

下次让AI帮你写这个项目的需求文档，它会自动遵循这些规则，不用每次重复交代。

说人话：云端画像让AI”认识”你，用户级记忆让AI”守规矩”，工作区级记忆让AI”懂项目”。

二、目录结构全景：比你想的大一倍

三层记忆（MEMORY.md + 云端画像）只是”记忆”部分。打开.workbuddy目录你会发现，实际还有一整套人格层和协议层文件。

完整结构如下（别怕别怕，做B端PM从来都不知道“怕”字是怎么读）：

上一节讲了MEMORY.md和云端画像，接下来重点讲这5个文件：IDENTITY.md、USER.md、SOUL.md、AGENTS.md、global.md。

三、人格层4文件：AI的”性格说明书”

IDENTITY.md、USER.md、SOUL.md、AGENTS.md，这4个文件合称人格层。它们决定了AI”是谁””你是谁””怎么干活”。

各管什么

前3个文件（IDENTITY、USER、SOUL）在首次启动WorkBuddy时，系统会通过引导流程帮你生成。大多数人生成之后就没再管过——确实，这3个不太需要改，系统生成的够用了。

但AGENTS.md必须自己写，写了效果立竿见影。

AGENTS.md：AI的”工作手册”

AGENTS.md管的是”AI干活时怎么动”——表达风格、工具调用逻辑、输出长度、交付标准、禁止行为。说白了，就是你给新人定的那个SOP。

不写会怎样？AI用默认风格干活——输出可能太长、格式不对、该问时不问、不该决定时替你决定。

B端PM实战案例——AGENTS.md这样写：

## 表达与输出

– 所有文档输出用Markdown格式，不要Word

– PRD中的权限矩阵统一用”角色-功能-操作”三级表格

– 结论先行，再展开细节## 歧义处理- 需求不清楚时，先追问目标再动手，不要猜

– 有多个方案时，列出优劣对比让我选，不要替我拍板

## 输出长度

– 快速判断类：不超过3段，结论优先

– 方案类：先给结论段，细节按需展开

– 执行报告：只输出差异和遗留问题

## 禁止

– 不确定不编，不编造数据或调研结果

– 不替我做产品决策（优先级、功能取舍）

– 改文件前先读全文件

保存到C:Users你的用户名.workbuddyAGENTS.md，下次对话你就能感觉到AI”规矩”多了。

几点注意

• 人格层文件只在用户级路径生效。放到项目级目录下会被直接忽略——人格是强制全局的，不允许项目覆盖。
• 前3个文件可以改，但别乱改。SOUL.md里写”你是一个毒舌的AI”，AI就真会怼你……别问我怎么知道的。
• AGENTS.md按需创建。首次使用时不存在是正常的，手动建一个就行。

四、global.md：跨项目的”硬约定”

MEMORY.md（用户级）和global.md都在memory目录下，这俩有什么区别？

简单记：

• MEMORY.md：偏”偏好”和”知识”——”输出用Markdown””我是B端PM，主要做SaaS”
• global.md：偏”协议”和”规约”——”文件命名规范””代码风格””提交格式”

MEMORY.md像”你告诉AI你的习惯”，global.md像”你给AI定的制度”。

B端PM实战案例——global.md这样写：

## 文件管理

– 文档命名：YYYY-MM-DD-描述.md，统一放项目docs目录

– 临时文件不放项目根目录

– 敏感信息（客户名、合同金额）不写进md文件

## 输出规范

– 所有表格用Markdown格式

– 流程图用Mermaid语法

– 中英文之间加空格

## 工作规约

– 每次任务完成后，输出变更摘要（改了什么、为什么改）

路径：C:Users你的用户名.workbuddymemoryglobal.md

三个”跨项目文件”对比

global.md、用户级MEMORY.md、工作区级MEMORY.md，这仨容易混：

一句话区分：global.md管”怎么干活”，MEMORY.md管”干什么活”。

五、优先级与冲突裁决：三层打架时谁说了算

冲突场景

假设你三层都写了关于”文档工具”的规则：

• • 用户级MEMORY.md：”资料整理优先输出docx”
• • 工作区级MEMORY.md：”本项目文档用markdown”
• • 当前对话你说：”这次先用Notion记一下”

裁决结果：Notion > markdown> docx

会话级压项目级，项目级压用户级。换个没有项目级覆盖的项目，规则回到Obsidian。

这就是”越近、越具体，优先级越高”。

加载顺序 ≠ 优先级

会话启动时，文件被读进context的先后顺序是：

IDENTITY.md → USER.md → SOUL.md → AGENTS.md → global.md → MEMORY.md（项目级） → 今日日志

这是”加载序”，偏人格和知识层的初始化。冲突裁决则是另一回事——模型拿到所有内容后，按”越具体越高”判谁压谁。

两件事别混。加载在前的不一定优先级高。

喂记忆的最佳实践

六、避坑指南

7条，每条都是踩出来的。

1. 云端画像只能通过”设置→记忆”管理。直接改本地缓存文件会被覆盖，下次同步就把你的修改冲掉。
2. 用户级记忆别写太细。把某项目的配色方案写进用户级，到别的项目也会被继承，还得在项目级再覆盖一次。用户级只放”真的所有项目都通用”的，项目特例一律下沉到项目级。
3. 换电脑不会自动同步。所有本地文件都不走云端同步，换电脑需要手动迁移整个.workbuddy目录。
4. 人格层文件只认用户级路径。把AGENTS.md放到项目目录下不会生效，系统直接忽略。
5. global.md和MEMORY.md别写重复内容。两个文件都有”输出用Markdown”，AI不会报错，但浪费context空间，还可能困惑。格式/命名/规约放global.md，偏好/知识/项目规则放MEMORY.md，分工明确。
6. 每日日志不是规则库。YYYY-MM-DD.md是过程记录，自动追加。想长期生效的规则必须写到MEMORY.md里。日志超过30天建议蒸馏到MEMORY.md后删掉。
7. AGENTS.md里的”禁止”条款最有用。写了”不替我做产品决策”，AI给方案时会自动加上”以上供参考，最终由你决定”——比没写时乖多了。

最后总结

三层记忆让AI”认识”你，人格层和协议层让AI”守规矩”。

真正用好WorkBuddy的人，不是对话最多的人，是把配置文件写得最认真的人。