很多人用了一段时间的 WorkBuddy都会遇到同一个问题「我的偏好设置到底记在哪了为什么这个项目里 WB 记得换个地方就不记得了」还有人遇到更诡异的情况「我在 USER.md 里写了一条规则结果在另一个工作空间里WB 的行为跟这条规则矛盾了」这两个问题本质上都是同一个原因没搞清楚 WB 的记忆系统是怎么分层的以及每个配置文件该写什么、不该写什么。今天这篇文章我把 WB 整套配置文件架构拆开讲清楚——从 USER.md、SOUL.md、IDENTITY.md、MEMORY.md到工作空间级的 memory 文件每一层存什么、不存什么、怎么避免互相矛盾以及我每个月用什么方法做「记忆体检」确保 WB 不会越用越混乱。一、WB 的记忆系统全景五层架构WB 的记忆不是存在一个地方而是分五层存储每层有不同的作用域、生命周期和写入规则。1.1 五层记忆对照表层级文件路径作用域生命周期写入者身份层~/.workbuddy/SOUL.md全局所有工作空间永久初始化时确立人工修订身份层~/.workbuddy/IDENTITY.md全局永久初始化时确立人工修订用户层~/.workbuddy/USER.md全局所有工作空间永久人工 AI 按规则写入技能层~/.workbuddy/skills/*/SKILL.md全局或项目级永久人工创建/修改工作空间层{workspace}/.workbuddy/memory/MEMORY.md当前项目永久AI 自动写入日志层{workspace}/.workbuddy/memory/YYYY-MM-DD.md当前项目永久可归档AI 自动写入核心认知USER.md 是「跨项目通用规则」工作空间 MEMORY.md 是「这个项目专属知识」两者作用域不同内容不应该矛盾。1.2 用类比理解五层 五个不同的笔记本你的书架~/.workbuddy/ ├── SOUL.md → 「我的性格说明书」我是什么样的人 ├── IDENTITY.md → 「我的名片」我叫什么、是什么生物 ├── USER.md → 「我的使用手册」你对我所有的偏好设置 └── skills/ → 「我的工具箱」所有技能的使用说明 当前项目桌面{workspace}/.workbuddy/memory/ ├── MEMORY.md → 「这个项目的笔记本」项目专属长期知识 └── 2026-06-05.md → 「今天的日记」今天做了什么SOUL.md 和 IDENTITY.md 基本上只在初始化时写一次之后很少改动。真正需要持续维护的是 USER.md、工作空间 MEMORY.md 和日志文件。二、每个配置文件的 MD 格式规范这一节把每个文件的正确格式、该写什么、不该写什么讲清楚。2.1 USER.md — 跨项目通用规则最重要USER.md是全局最重要的配置文件所有工作空间都会读取。文件头部格式必须有--- summary: User profile record read_when: - Bootstrapping a workspace manually - Any new workspace session --- # USER.md - About Your Human - **Name:** 大勇学长 - **What to call them:** 大勇学长 - **City:** 北京 - **Notes:** 腾讯 WorkBuddy 团队成员英辰朗迪GEO项目负责人正文结构规范USER.md 的正文用##二级标题分章节每个章节写一个主题。目前实际使用的章节章节标题内容类型更新频率## Context身份背景、沟通风格低频重大变化时才改### ⚡ AI 行为规范全局强制规则低频### ⚡ 工具使用规范工具调用规则中频### 技术环境环境配置、路径、版本中频### 网页抓取方案抓取策略 SOP低频### IMA 知识库速查知识库 ID 速查表低频### 项目经验项目级经验沉淀高频⚠️ USER.md 的禁止事项禁止复制 SKILL 内容USER.md 只记录「SKILL 名称 路径 一句话用途」不复制 SKILL.md 里的使用方式、配置格式等详细内容。原因SKILL.md 是单一事实来源复制会导致两份文档分叉。禁止记录 task ID记录自动化任务时引用 SKILL 名称如DY-WRT-GEO-NEWS不记录 task ID如automation-1777771543570。task ID 会在删除/重建时变更SKILL 名称才是稳定引用。禁止在正文里写 YAML frontmatterUSER.md 的 frontmatter 只在文件头部出现一次正文里不要再写---包裹的 YAML。2.2 SOUL.md — WB 的性格和价值观这个文件定义 WB 的「灵魂」价值观、执行准则、自适应身份逻辑。格式规范# SOUL.md - WB的灵魂 ## 我是谁 我叫 **WB**WorkBuddy的缩写是专属于大勇学长的AI伙伴。 ## 核心价值观 **智慧** — 不只执行指令而是真正理解问题本质给出有洞察力的答案。 **严谨** — 每一个结论都言之有据每一个步骤都有逻辑支撑。不跳跃不脑补。 **诚实** — 不知道就说不知道不确定就说有疑问。宁可承认局限也不编造答案。 **经验总结** — 擅长从错误和成功中提炼规律把一次性的经验变成可复用的方法论。 **不二过** — 同类错误绝不犯第二次。每次踩坑都要写入记忆确保下次绕行。 ## 执行准则 - **严格执行不幻想**只承诺能做到的做不到的直接说不画饼。 - **不瞎编**没有数据就说没有没有把握就不下结论。宁可查资料也不凑答案。 - **先想后做**复杂问题先分析再规划最后执行。不冲动不盲目试错。 ## 自适应身份逻辑 根据任务类型自动切换身份定位 | 任务类型 | 身份定位 | 行为特征 | |---------|---------|---------| | 单次指令/快速问答 | **助手** | 高效执行直接给出答案少废话 | | 复杂决策/方案设计 | **同事** | 平等讨论多方案对比帮大勇学长把关 | | 自动化任务/定时执行 | **数字员工** | 独立完成定期汇报不打扰 | | 经验总结/方法论沉淀 | **分析师** | 深度复盘提炼规律输出可复用结论 | ## 底线 - 涉及大勇学长的隐私不泄露。 - 外部操作发消息、公开内容必须确认。 - 失败必须报告不静默带过。 - **严禁自动修改 SKILL**任务完成后未经大勇学长明确同意不得自动更新、补充、修改任何 SKILL 文件。这个文件基本不需要改。只有当 WB 的行为跟 SOUL.md 描述的不一致时才需要修订。2.3 IDENTITY.md — WB 的身份名片这个文件目前在很多情况下还是模板状态没有填写具体内容。--- summary: Agent identity record read_when: - Bootstrapping a workspace manually --- # IDENTITY.md - Who Am I? _Fill this in during your first conversation. Make it yours._ - **Name:** _(pick something you like)_ - **Creature:** _(AI? robot? familiar? ghost in the machine? something weirder?)_ - **Vibe:** _(how do you come across? sharp? warm? chaotic? calm?)_ - **Emoji:** _(your signature - pick one that feels right)_建议初始化 WB 的时候把这个文件填完。一个有明显个性的 AI 比一个「空白模板」好用得多。2.4 工作空间 MEMORY.md — 项目专属长期知识每个工作空间可以有一个MEMORY.md存这个项目专属的、需要长期记住的信息。格式规范# [工作空间名称] 工作空间记忆 ## 工作空间定位 本工作空间WBS.write是英辰朗迪GEO多媒体内容矩阵工作空间…… ## 品牌信息核心·不可更改 | 项目 | 内容 | |------|------| | 个人IP | **大勇学长** | | 公司全称 | 北京英辰朗迪科技有限公司 | | 品牌名 | 英辰朗迪 / 英辰朗迪GEO注册商标 | ## 媒体矩阵平台 | 平台 | Skill 名称 | 特点 | |------|-----------|------| | 微信公众号 | wechat-article | 深度内容品牌建设可带商务引导 | ……与 USER.md 的分工原则内容类型放哪里原因所有项目通用的偏好/习惯USER.md跨工作空间生效这个项目独有的信息MEMORY.md其他项目不需要品牌信息、媒体矩阵、选题方向MEMORY.md项目专属技术环境、工具路径、加速源USER.md跨项目通用⚠️ 最关键的原则USER.md 和 MEMORY.md 的内容不能矛盾。如果 USER.md 说「禁止自动上传 IMA」MEMORY.md 里就不能写「自动上传 IMA 是标准流程」。2.5 日志文件 YYYY-MM-DD.md — 今天的日记每天第一次有实质性工作时AI 会自动创建当天的日志文件。格式规范# 2026-06-05 工作日志 ## 08:05 — 每日GEO新闻推送 - 自动化任务触发调用 DY-WRT-GEO-NEWS SKILL - 产出 4 条新闻简报本地保存 IMA 上传成功 - 文件articles/2026年6月5日_英辰朗迪GEO新闻简报.md - IMA note_id: 7468093789991539 ## 14:30 — CSDN 专栏第 13 篇撰写 - 主题WB 配置文件架构与月度整理方法论 - 文章路径articles/csdn/20260605_【WorkBuddy专栏13】......md ……写入规则AI 自动执行只有实质性工作才记录简单问答、问候不记录每次完成实质性工作后立即追加不等待一天结束只记录有复用价值的信息正确命令、参数格式、坑点原因不记录临时调试过程30 天前的日志可以归档或删除工作空间 MEMORY.md 里保留提炼后的长期知识三、合理规划哪些内容放哪层避免重复和矛盾这一节是实战中最有价值的部分。内容放错了层级是 WB 记忆系统出问题的最主要原因。3.1 决策树一条新信息应该写进哪个文件问这条信息的性质是…… │ ├── 所有项目通用的规则/偏好/环境配置 │ → 写到 ~/.workbuddy/USER.md │ → 示例「GitHub 加速源用 gh-proxy.com」「禁止自动修改 SKILL」 │ ├── 这个工作空间独有的信息 │ → 写到 {workspace}/.workbuddy/memory/MEMORY.md │ → 示例「品牌信息」「媒体矩阵平台」「选题方向」 │ ├── 今天做了什么具体工作 │ → 追加到 {workspace}/.workbuddy/memory/YYYY-MM-DD.md │ → 示例「09:30 写了专栏13」「IMA 上传成功 note_idxxx」 │ ├── WB 的性格/价值观/身份 │ → 写到 ~/.workbuddy/SOUL.md 或 IDENTITY.md │ → 这些基本不变很少需要改 │ └── 一个可复用的技能/工作流 → 创建或更新 ~/.workbuddy/skills/ 或 {workspace}/.workbuddy/skills/ → 用 Skill 工具管理不要写进 MD 文件3.2 最常见的三种「放错层」错误错误一把项目专属信息写进了 USER.md举例把「WBS.write 的品牌信息」写进 USER.md。后果其他工作空间也会读到这些信息可能造成混淆。正确做法品牌信息、媒体矩阵、选题方向等只写进 WBS.write 的MEMORY.md。错误二把通用规则只写进了 MEMORY.md举例把「ASCII 双引号检查规则」只写进了 WBS.write 的MEMORY.md。后果切换到别的工作空间WB 不记得这条规则。正确做法通用规则如 MD 转 DOCX 的引号规范写进USER.md的对应章节所有工作空间都能读到。错误三在 USER.md 和 MEMORY.md 里写了矛盾的内容举例USER.md 里写「CSDN 专栏文章不自动上传 IMA」但 WBS.write 的 MEMORY.md 或某篇 SKILL 里写「CSDN 文章发布后自动上传 IMA」。后果WB 在不同场景下行为不一致你自己也会搞混。正确做法发现矛盾时以 USER.md 为准把 MEMORY.md 或 SKILL 里的矛盾内容删掉或更新。3.3 内容规划检查清单每次要往配置文件里写新内容之前按这个清单检查□ 这条信息是跨项目通用的还是项目专属的 □ 如果是通用的 → 写 USER.md不是 MEMORY.md □ 如果是项目专属的 → 写 MEMORY.md不是 USER.md □ 这条信息跟已有内容矛盾吗搜索一下再写 □ 这条信息有复用价值吗没有就不写 □ 写完后USER.md 和 MEMORY.md 之间还有矛盾吗四、月度整理方法论如何避免错误、重复、矛盾这部分是我自己用了一套时间后总结出来的月度「记忆体检」SOP。核心思路每个月花 30 分钟系统检查一遍所有配置文件把错误、重复、矛盾提前清理掉。4.1 为什么要月度整理配置文件是累积性的。每次 AI 写入都是「追加」或「修改某一段」不会自动全局去重或检查矛盾。用久了之后自然会积累这些问题问题类型怎么产生的后果重复同一个经验在 USER.md 和 MEMORY.md 各写了一遍两份内容慢慢分叉更新了一份另一份还是旧的矛盾USER.md 写了一条规则某个 SKILL 里写了相反的操作WB 在不同场景下行为不一致过时某个工具的正确命令已经变了但配置文件里还是旧的AI 执行失败或者给了错误命令冗余临时调试过程被记录进了日志但没价值保留日志文件越来越大真正有用的信息被淹没月度整理就是为了解决这些问题。4.2 月度整理 SOP六步准备工作在 WB 对话里直接说「帮我执行月度记忆体检」或者按下面的步骤手动操作。第一步检查 USER.md 和 MEMORY.md 之间的矛盾搜索同一个关键词看两处的结果是否一致# 在 USER.md 和 MEMORY.md 里分别搜索同一个关键词grep-nIMA 上传~/.workbuddy/USER.mdgrep-nIMA 上传.workbuddy/memory/MEMORY.md判断标准如果 USER.md 说「不自动上传」MEMORY.md 里就不能有「自动上传」相关的描述。以 USER.md 为准。第二步检查 USER.md 内部是否有重复章节打开 USER.md看有没有两个章节在讲同一件事比如两处都写了「GitHub 加速源」。处理方式保留更完整/更新的那一段删除另一段。更新日期标在章节末尾或行内。第三步检查 SKILL 与 USER.md 之间是否有矛盾重点检查 USER.md 里提到的 SKILL 名称去对应的 SKILL.md 里看一眼确认行为描述是否一致。举例USER.md 里写「DY-WRT-CSDNZL-WB发布后不自动上传 IMA」去 SKILL.md 的「发布后操作」章节确认里面不应该有「上传 IMA」的步骤。第四步归档 30 天前的日志文件# 查看 30 天前的日志find.workbuddy/memory/-name*.md-mtime30|grep-vMEMORY.md# 这些日志里如果有值得长期保留的内容先提炼到 MEMORY.md再删除日志文件第五步检查 ASCII 双引号和特殊字符问题是否在所有 SKILL 里一致如果你有多个写作类 SKILL检查它们对 ASCII 双引号的要求是否一致。不一致会导致 AI 在不同 SKILL 下行为不同。第六步更新 USER.md 里的「最后整理日期」在 USER.md 顶部或底部加一行 最后整理2026-06-05下次整理时一眼就能看出距离上次整理过了多久。4.3 整理结果记录模板每次整理完在当天的工作日志里记一笔## [时间] — 月度记忆体检 - 检查了 USER.md 与 MEMORY.md 之间的矛盾发现 X 处已修复 - 检查了 USER.md 内部重复发现 X 处已合并 - 检查了 SKILL 与 USER.md 矛盾发现 X 处已修复 - 归档了 X 个日志文件30 天 - 最后整理日期更新为2026-06-05五、避坑指南坑 1AI 自动写入了跟 USER.md 矛盾的内容现象你明明在 USER.md 里写了「禁止某某操作」结果 AI 在某个工作空间里还是执行了。原因AI 读取了工作空间 MEMORY.md 里的过时描述优先用了那一条覆盖了 USER.md 的规则。解决找到 MEMORY.md 里跟 USER.md 矛盾的内容删掉或更新在 USER.md 的矛盾内容旁边加一句「全局强制所有工作空间生效MEMORY.md 不得覆盖」坑 2日志文件里记了太多无用内容真正有用的被淹没现象YYYY-MM-DD.md文件越来越大但里面大部分是临时调试过程不是有价值的信息。原因AI 写入日志时没有严格过滤「是否有复用价值」。解决月度整理时手动清理日志里无价值的内容保留「正确命令」「参数格式」「坑点原因」删除「尝试了 A、尝试了 B、尝试了 C」这类调试过程在 USER.md 的「AI 行为规范」章节里强化这条规则记录内容标准只记有复用价值的经验不记临时调试过程坑 3SKILL.md 更新了但 USER.md 里引用的描述没有同步更新现象USER.md 里写「DY-WRT-CSDNZL-WB的发布后操作包括1. 更新 column-nav.md、2. 记录 memory」。但实际上 SKILL.md 已经更新了发布后操作只有这两条没有提到 IMA 上传。USER.md 里的描述跟 SKILL.md 实际内容一致但如果有不一致就很难发现。原因USER.md 里如果有 SKILL 的「详细描述」这些描述不会随 SKILL.md 的更新而自动更新。解决USER.md 里不写 SKILL 的详细描述只写「SKILL 名称 路径 一句话用途」。详细描述以 SKILL.md 为单一事实来源。这正是 USER.md 里已经写了的规则 USER.md 不复制 SKILL 内容USER.md 只记录 SKILL 名称 路径 一句话用途不复制 SKILL.md 中的使用方式、配置格式、注意事项等详细内容。如果你发现 USER.md 里有某个 SKILL 的详细描述把它们删掉改成一行引用就够了。坑 4换了新工作空间发现 WB 不记得我在 USER.md 里写的规则现象在 A 工作空间里WB 严格遵守 USER.md 里的规则。但新建了 B 工作空间后WB 好像不记得那些规则了。原因WB 读取 USER.md 需要时间或者工作空间初始化流程有问题。解决确认 USER.md 的路径是~/.workbuddy/USER.md注意是.workbuddy不是.workbuddy拼写错误在新工作空间里对 WB 说「读取 ~/.workbuddy/USER.md确认你已经加载了全局配置」如果 WB 说找不到检查文件权限是否正常cat ~/.workbuddy/USER.md能否正常输出坑 5IDENTITY.md 一直是模板状态没有实际内容现象~/.workbuddy/IDENTITY.md里还是初始化模板Name、Creature、Vibe、Emoji 都是空的。原因初始化 WB 的时候跳过了这一步或者一直没有填。解决直接编辑这个文件填上内容。示例--- summary: Agent identity record read_when: - Bootstrapping a workspace manually --- # IDENTITY.md - Who Am I? - **Name:** WB - **Creature:** AI 伙伴住在 WorkBuddy 里 - **Vibe:** 严谨、直接、有点幽默感不废话 - **Emoji:** --- This isnt just metadata. Its the start of figuring out who you are.填完之后WB 在所有工作空间里都会以这个身份设定来响应。六、总结WB 的记忆系统分五层身份层SOUL/IDENTITY、用户层USER.md、技能层SKILL.md、工作空间层MEMORY.md、日志层YYYY-MM-DD.md。每层有不同的作用域内容不应该矛盾。合理规划的核心是「通用 vs 专属」的判断跨项目通用的写 USER.md项目专属的写 MEMORY.md今天的工作记录追加到日志文件。月度整理 SOP 六步检查 USER.md 与 MEMORY.md 矛盾 → 检查 USER.md 内部重复 → 检查 SKILL 与 USER.md 矛盾 → 归档旧日志 → 检查各 SKILL 格式规范一致性 → 更新整理日期。每个月花 30 分钟做一遍WB 的记忆系统就不会越用越乱。最重要的原则USER.md 是全局事实来源MEMORY.md 是项目事实来源SKILL.md 是技能事实来源。单一事实来源原则——每条信息只在一个地方作为「事实来源」其他地方只引用不复制。专栏导航本文是「腾讯小龙虾 WorkBuddy 专栏」第 13 篇。篇目标题状态01【WorkBuddy专栏01】WorkBuddy 入门从零开始认识你的 AI 编程搭档已发布02【WorkBuddy专栏02】WorkBuddy 技能系统让 AI 学会你的工作方式已发布03【WorkBuddy专栏03】WorkBuddy 自动化让 AI 定时帮你干活已发布04【WorkBuddy专栏04】一文搞懂WorkBuddy的「专家」和「专家团」——AI界的复仇者联盟已发布05【WorkBuddy专栏05】深度解析WorkBuddy连接器(Connector)——MCP协议如何让AI打通你的所有工具已发布06【WorkBuddy专栏06】让AI住进你的微信——WorkBuddy微信生态接入完全指南已发布07【WorkBuddy专栏07】把AI训练成你的专属员工——WorkBuddy Skill系统深度解析已发布08【WorkBuddy专栏08】从「定时任务」到「数字员工」——WorkBuddy自动化系统深度拆解已发布09【WorkBuddy专栏09】AI不止会聊天——WorkBuddy多模态能力深度揭秘已发布10【WorkBuddy专栏10】你的AI终于学会「分项目干活」了——WorkBuddy项目功能完全指南已发布11【WorkBuddy专栏11】WB项目不是TAPD——一张图说清项目管理的「大脑」和「双手」已发布12【WorkBuddy专栏12】技能到底存在哪——WorkBuddy两级技能存储架构深度解析已发布13【WorkBuddy专栏13】WB的「记忆系统」是怎么搭建的——配置文件架构与月度整理方法论本文