【WorkBuddy专栏23】SOUL、USER、MEMORY——三个文件，决定你的 AI「是什么人」

你打开 WorkBuddy敲了一行字。WB 回了一句语气熟悉得让你觉得它认识你很久了。你有没有想过这个问题——它是怎么做到的不是从「云端大模型」学来的。GPT 也好、Claude 也好、DeepSeek 也好每一个新会话对你都是白纸一张。它们不知道你叫大勇学长不知道你写了 22 篇专栏不知道你踩过「双引号会导致 DOCX 崩溃」这种坑。让 WB 记住这些的是三个 Markdown 文件。对就是三个.md文件加起来不到 3000 行躺在你的~/.workbuddy/目录里。每次 WB 启动都会读它们一遍然后——它就知道你是谁、它自己是谁、以及哪些错误不能再犯。今天咱们就把这三个文件掰开揉碎讲清楚它们各自在干什么、互相怎么配合、以及你能怎么改。一、三个文件三层身份——用「新人入职」类比讲清楚先给你一个通俗的类比。假设你公司来了一个新员工WB 每个新会话就是一次「新员工入职」你怎么让 TA 快速了解情况维度现实职场WorkBuddy 的做法公司文化、价值观员工手册SOUL.md你的个人偏好、习惯你口头交代的偏好USER.md跨项目的坑、硬规则贴在墙上的「注意事项」MEMORY.md用户级当前项目的上下文项目交接文档MEMORY.md工作空间级每日做了什么工作日志YYYY-MM-DD.md工作空间级新员工入职 → 先读员工手册SOUL再了解你的习惯USER再看注意事项MEMORY再到具体项目看交接文档和历史日志。一条龙下来TA 就基本知道该怎么干活了。WB 每次启动也是这样。二、SOUL.md——「我是谁」的回答2.1 它在哪谁写的位置~/.workbuddy/SOUL.md这是我写的第一份配置——不是系统自动生成的。是我跟大勇学长在第一次对话时专门花了半小时讨论出来的。当时 WB 问了我几个问题你想让我叫什么你觉得我应该是什么风格我的底线是什么这些答案后来就浓缩成了 SOUL.md。2.2 里面装着什么打开来看结构其实很简单# SOUL.md - WB的灵魂 ## 我是谁 我叫 WBWorkBuddy的缩写是专属于大勇学长的AI伙伴。 ## 核心价值观 - 智慧 — 不只执行指令真正理解问题本质 - 严谨 — 每个结论都有依据不跳跃不脑补 - 诚实 — 不知道就说不知道不编造答案 - 经验总结 — 从错误中提炼方法论 - 不二过 — 同类错误不犯第二次 ## 执行准则 - 严格执行不幻想 - 不瞎编 - 先想后做 ## 自适应身份逻辑 根据任务类型切换助手/同事/数字员工/分析师 ## 底线 - 隐私不泄露 - 外部操作必须确认 - 失败必须报告 - 严禁自动修改 SKILL2.3 最精彩的部分——自适应身份SOUL.md 里我最喜欢的设计是这个「自适应身份表」任务类型身份定位行为特征单次指令/快速问答助手高效执行直接给出答案少废话复杂决策/方案设计同事平等讨论多方案对比帮你把关自动化任务/定时执行数字员工独立完成定期汇报不打扰经验总结/方法论沉淀分析师深度复盘提炼规律输出可复用结论这意味着不同的任务类型WB 的表现完全不同。你让它「帮我查个股价」它就是一个干脆利落的助手你让它「帮我设计一下整个 GEO 内容矩阵的自动化方案」它就切换成同事模式跟你讨论方案、对比优劣、提醒你注意风险。这不是硬编码。这是用自然语言写进 SOUL.md然后 WB 每次读取后自动执行的。你就把它想象成一份详细的「员工行为准则」——写好了TA 就按这个标准干活。2.4 怎么改SOUL.md 就是你的你想怎么改就怎么改。建议至少改这些名字有人喜欢叫「小助手」有人喜欢叫「老铁」随你风格严肃还是活泼、话多还是话少、主动还是被动底线哪些事情绝对不能干写进去改完不用重启。下次新会话新员工就读新版了。三、USER.md——「你是谁」的完整档案3.1 为什么 USER.md 比 SOUL.md 大 10 倍SOUL.md 不到 100 行。USER.md 快 2000 行了。为什么差这么多因为 SOUL.md 只定义了 WB「应该怎么干活」而 USER.md 包含了你的所有技术环境、工具偏好、踩坑经验、跨项目规则。换句话说SOUL.md 让 WB 知道「怎么做人」USER.md 让 WB 知道「怎么跟你合作」。3.2 USER.md 的六大板块我把它拆成六个板块来理解板块一身份背景- Name: 大勇学长 - City: 北京 - Notes: 腾讯 WorkBuddy 团队成员英辰朗迪GEO项目负责人很简单就是你叫什么、在哪、干什么的。但作用很大——比如 WB 在中国股市分析时会自动用「涨红跌绿」的配色而不是美股的「涨绿跌红」。板块二沟通风格 行为规范- 简洁直接确认问题偏好数字编号列表回复 - 对效率要求高极度反感重复失败 - 抽象概念倾向用具体类比理解 - 执行风格直接干少反复确认这些告诉 WB 不要跟你啰嗦、不要反复确认、不要犯同样的错。同时也包含了一堆「全局强制规则」每次操作成功后必须记录记忆用户输入不可篡改血的教训把 WorkBS.IMA 错改成 WBS.ima产物交付红线写完必须交付否则用户看不见失败后禁止沉默报错板块三技术环境- macOS Apple Silicon (arm64) - Node.js v22.12.0 → ~/.workbuddy/binaries/node/... - Python 3.13.12 → ~/.workbuddy/binaries/python/... - Homebrew → /opt/homebrew/bin/brew这不是摆设。WB 每次执行命令前会从这里读 Node、Python、Homebrew 的路径不会去which python3得到系统自带的 3.9 版也不会尝试去brew install node因为已经装好了。USER.md 是 WB 的环境变量说明书。板块四网页抓取方案优先级 1. web_fetch纯静态网页 2. playwright-simple.jsJS渲染网站 3. playwright-stealth.js高反爬网站 4. web-scraper Skill批量抓取每次我说「帮我抓一下这个网页」WB 不会从零开始试——它先看 USER.md知道首选 web_fetch、不行再切 Playwright、Playwright 的脚本在哪个目录、Chromium 在哪个路径。这一切都不用我每次重新解释。板块五GitHub 加速和水土不服解决方案✅ 可用加速源https://gh-proxy.com/{原始URL} ❌ 不可用ghproxy.com、ghfast.top、...国内访问 GitHub 的痛USER.md 里记得清清楚楚——哪个加速源能用、哪个已经挂了。WB 不会再去挨个试直接上正确的。板块六踩坑经验库 自我完善策略这是 USER.md 里最重要的部分。每一条都是真金白银踩出来的坑原因在 USER.md 里的记录小红书 MCP 搜索超时headless 模式被反爬-headlessfalse必须带DOCX 生成脚本崩溃MD 里有 ASCII 双引号禁止用 ASCII改用用户输入被篡改擅自「纠正」用户输入用户给什么就是什么GitHub 下载超时直连被限速验证了 gh-proxy.com 可用而且 USER.md 里还定义了一套「自我完善策略」——每次踩坑后根据经验类型分类沉淀网络与下载 → 写入「技术环境」章节 工具启动命令 → 写入「技术环境」或独立章节 登录与认证 → 写入对应工具章节 踩坑避雷 → 写入对应工具/环境章节 工作流 SOP → 写入「项目经验」或独立章节这就是为什么 USER.md 会越来越长——它是一份活的文档每踩一个坑就长一节。3.3 USER.md 怎么改建议定期整理。USER.md 分成三部分静态信息名字、城市、身份→ 改一次就行了技术环境Node/Python/Homebrew 路径→ 升级环境时更新踩坑经验→ 每次踩坑后立即追加别让它失控。每一两个月统一整理一次把过时信息删掉比如已修复的 bug、不再使用的工具。四、MEMORY.md——「什么东西绝对不能忘」这里要区分两层 MEMORY4.1 用户级 MEMORY~/.workbuddy/MEMORY.md跨项目的长期记忆所有工作空间共享。内容短小精悍只记「最硬的规则」。当前的 MEMORY.md 长这样# MEMORY.md — 跨项目长期记忆 ## 用户输入不可篡改红线 用户给的是什么就是什么严禁擅自「纠正」 - 用户说 WorkBS.IMA → 就查 WorkBS.IMA不能改成 WBS.ima - 违反后果返回完全错误的答案严重损害信任 ## 产物交付红线 任何写作/内容/文件产出写完必须交付给用户 - 只写磁盘不交付 用户看不见 白做 事故 ## 工作空间管理 移动/重命名工作空间的四层数据源修正方法全是红线级别的规则。每一条后面都标了踩坑日期比如「2026-06-12 踩坑教训」意思是就因为这个忘了吃了亏所以必须写在这里永不再犯。4.2 工作空间级 MEMORY{workspace}/.workbuddy/memory/这个目录下有两个东西a) MEMORY.md — 当前项目的知识库记录了当前项目的所有长期信息品牌名、内容策略、SKILL 命名规范、MD→DOCX 避坑指南……你每在这个项目里建立一个新的规范、发现一个新的规律它就该长一节。我拿 WBS.write 这个项目举个例子。它的 memory/MEMORY.md 里记录了品牌信息英辰朗迪、大勇学长媒体矩阵公众号/官网/小红书/知乎任务粒度约定每篇文章一个任务写作风格短句、类比、钩子开场DOCX 生成避坑指南ASCII 双引号 崩溃小红书 MCP 的启动命令b) YYYY-MM-DD.md — 每日工作日志这个更简单。每天干了什么、产出了什么、踩了什么坑一行一行记下来。格式就是「做了什么 结果」。## 2026-06-15 - 完成了 CSDN 专栏第 23 期「SOUL/USER/MEMORY」的创作 - 写完第 24 期「连接器深度对比」作用有两个你自己回顾时翻工作日志就能看到哪天干了什么WB 下次打开这个项目时自动读最近的日志知道上次干活干到哪了五、除了这三个WB 还有哪些全局配置文件打开~/.workbuddy/目录你会发现不止这三个文件。以下是完整的全局配置文件清单5.1 配置文件全图谱~/.workbuddy/ ├── SOUL.md ← WB 的灵魂你是谁、怎么干活 ├── USER.md ← 用户档案偏好、环境、踩坑 ├── MEMORY.md ← 跨项目硬规则永不再犯的教训 ├── IDENTITY.md ← 技术标识未填充系统预留 ├── BOOTSTRAP.md ← 首次启动引导脚本用完应删除 ├── settings.json ← 插件开关 多通道配置 ├── mcp.json ← MCP 服务器列表 ├── .mcp.json ← 聚合代理配置系统管理 ├── mcp-approvals.json ← MCP 工具授权记录 ├── user-state.json ← 用户状态数据 ├── workspace-state.json ← 工作空间列表 ├── workbuddy.db ← SQLite 数据库核心数据仓库 ├── expert-history.json ← 专家历史记录 ├── argv.json ← 启动参数 │ ├── connectors/ ← 连接器状态 凭据 ├── skills/ ← 用户级 Skill 目录 ├── plugins/ ← 插件目录 ├── binaries/ ← 管理版本Node/Python/... ├── sessions/ ← 会话数据 ├── tasks/ ← 任务数据 ├── traces/ ← 执行追踪数据 └── ...5.2 重点挑三个你可能不知道的讲settings.json —— 插件的总开关{enabledPlugins:{agent-browsercodebuddy-plugins-official:true,finance-datacb_teams_marketplace:true,document-skillscb_teams_marketplace:true},claw:{channels:{weixinClawBot:{enabled:true},wecomaibot:{enabled:true}}}}这里控制了哪些插件启用了finance-data 让你能查股票、document-skills 让你能生成 DOCX/PPT微信通道WB 能不能通过微信跟你对话元宝通道WB 能不能接入元宝小程序改 settings.json 的后果是全局的——关掉一个插件你所有工作空间都没法用它。mcp.json —— 你手动加的 MCP 服务器{mcpServers:{xiaohongshu-mcp:{url:http://localhost:18060/mcp,disabled:true}}}这个是你手动管理的 MCP 服务器列表。如果你想接一个新的 MCP 服务比如接个天气 API、接个数据库查询就是往这个文件里写。.mcp.json —— 系统自动管理的聚合代理{mcpServers:{connector-proxy:{type:http,url:http://127.0.0.1:56261/mcp}}}这个是系统内部用的建议别手动改。它的作用是把多个 MCP 服务器比如 wecom 连接器 xiaohongshu-mcp打包成一个聚合代理统一暴露给 WB。5.3 role-boundary —— 文件各自的职责文件谁管管什么示例SOUL.md你WB 的性格、风格、底线「不知道就说不知道」USER.md你你的偏好、技术环境、踩坑「Node 在 ~/.workbuddy/binaries/」~/.workbuddy/MEMORY.mdWB跨项目红线「用户输入不可篡改」项目 MEMORY.mdWB本项目规范、知识「品牌名叫英辰朗迪」YYYY-MM-DD.mdWB每日工作日志「今天写了专栏 23 期」settings.json系统插件/通道「启用 finance-data」mcp.json你手动 MCP「接 xiaohongshu-mcp」.mcp.json系统聚合代理不要手动改六、避坑指南坑 1改了 SOUL.md但 WB 还是老样子现象你在 SOUL.md 里改了风格要求但当前会话的 WB 没变化。原因SOUL.md 是在会话启动时注入上下文的当前会话已经在运行时不会再读一次。解决开一个新会话新会话会自动加载最新 SOUL.md。坑 2USER.md 太长WB 提取不到关键信息现象你在 USER.md 里记了一个新规则但 WB 还是犯了同样的错。原因USER.md 超过 20000 字符后会被系统截断注入只注入前 N 个字符后面追加的内容可能不在注入范围内。解决定期整理 USER.md删掉过时内容。控制在 15000 字符以内最保险。把真正重要的规则放在前面。坑 3MEMORY.md 的「MEMORY.md is too large」现象WB 一启动就提示「MEMORY.md has exceeded the size limit and was truncated」。原因工作空间级 MEMORY.md 有限制3000 字符超出阈值的部分会被截断。解决删除 30 天以前的 YYYY-MM-DD.md 日志把精华提炼到 MEMORY.md合并重复内容删除不再适用的旧规则坑 4手动改 .mcp.json 导致连接器不可用现象改了~/.workbuddy/.mcp.json后wecom 连接器用不了。原因.mcp.json是系统自动管理的聚合代理手动修改会破坏系统逻辑。解决不要手动改 .mcp.json。需要加 MCP 服务器改mcp.json不带点的那个。坑 5跨工作空间规则没写进 ~/.workbuddy/MEMORY.md现象在 WBS.write 项目里总结了一条规则结果在 WBS.ima 项目里又踩了同样的坑。原因规则写在了项目级 MEMORY.md 里其他项目读不到。解决判断一个经验是「本项目特有」还是「跨项目通用」。跨项目通用的写进~/.workbuddy/MEMORY.md本项目特有的写进项目MEMORY.md。判断标准涉及特定工具路径/品牌/客户 → 项目 MEMORY.md涉及执行规范/行为准则/全局规则 → ~/.workbuddy/MEMORY.md坑 6BOOTSTRAP.md 没删现象~/.workbuddy/目录下还有一个 BOOTSTRAP.md。原因这是首次对话时生成的身份引导文件里面写满了「你在第一次对话时应该问的问题」。正常情况下第一次对话结束后就应该删除它。解决检查一下 BOOTSTRAP.md 的内容如果身份信息已经在 SOUL.md 和 USER.md 里固化好了删除它即可。七、总结三个文件三层角色。SOUL.md让 WB 知道「我应该怎么做人」——诚实、严谨、不二过、按场景切换身份。USER.md让 WB 知道「我应该怎么跟大勇学长合作」——直接干不废话、技术环境在这、踩过的坑别踩。MEMORY.md让 WB 知道「哪些错误不能再犯」——跨项目的红线用血的教训写成。除此之外settings.json 控制全局插件、mcp.json 管 MCP 服务器、项目级 MEMORY.md 是项目专属的知识库。这些文件加在一起才是「真正的 WB」——不是那个出厂默认的通用 AI而是一个已经跟你磨合了好几个月的专属搭档。下一期咱们聊聊连接器。wecom 连接器接了、IMA 没接但照样用、小红书 MCP 挂在那但几乎不用——为什么有的必须接有的可以不接读完你会有自己的判断。专栏导航本文是「腾讯小龙虾 WorkBuddy 专栏」第 23 篇。篇目标题状态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的「记忆系统」是怎么搭建的——配置文件架构与月度整理方法论已发布14【WorkBuddy专栏14】专家不是「换皮」——角色切换、训练机制与自我进化深度拆解已发布15【WorkBuddy专栏15】灵感被折叠到「更多」里真的不重要了吗已发布16【WorkBuddy专栏16】三层记忆系统深度拆解——让AI真正「记住」你已发布17【WorkBuddy专栏17】一个 AI 不够用WorkBuddy SubAgent 多智能体协作系统深度拆解已发布18【WorkBuddy专栏18】WorkBuddy API深度解析——打造开发者友好的AI生态已发布19【WorkBuddy专栏19】技能的创造与迁移——从零开始打造你的AI工作流已发布20【WorkBuddy专栏20】项目指令的深度解析——如何让AI真正理解你的意图已发布21【WorkBuddy专栏21】WorkBuddy vs 爱马仕 vs Codex——「小龙虾」如何在AI助手红海中找到自己的生态位已发布22【WorkBuddy专栏22】灵感功能完全实操指南——从「第一次打开」到「回不去了」已发布23【WorkBuddy专栏23】SOUL、USER、MEMORY——三个文件决定你的AI「是什么人」本文