先将结论明确：任何一个智能体，都离不开一套高效可靠的记忆系统。对于 CodeBuddy 而言，这套系统由四类核心文件构成——SOUL.md、USER.md、CODEBUDDY.md 和 daily-memories。它们各自承担不同职责：SOUL.md 定义行为内核，USER.md 固化开发者画像，CODEBUDDY.md 掌管全局控制开关，daily-memories 则用于沉淀每日决策与经验。

如果你期望 CodeBuddy 不仅仅是一个按指令执行任务的工具，而是能够真正理解你的项目风格、记住你偏好的技术选型、甚至延续上一次未完成的架构决策——那么，你需要为它注入一个可持久化、可演进、可复用的编程灵魂。

构建SOUL.md：定义智能体的行为内核

SOUL.md 是 CodeBuddy 记忆系统的核心配置文件。有人会问，它究竟起什么作用？简单来说，它不参与日常对话，却会在每次会话启动时自动加载，成为系统提示词的顶层约束。

操作上，在项目根目录创建一个 SOUL.md 文件，内容必须使用 YAML Frontmatter 开头：

name: 后端微服务架构师
description: 专注高可用、可观测、零信任安全的Go微服务实践，偏好Kitex+ETCD+OpenTelemetry栈

紧接着写入三类核心指令：

第一类是风格契约。例如：“所有 HTTP 错误响应必须返回 RFC 7807 标准 Problem Detail 格式，status 字段严格匹配 HTTP 状态码”。这是告诉 CodeBuddy 你的代码风格有哪些硬性要求。

第二类是技术红线。例如：“禁止使用 goroutine leak 风险高的 sync.Pool，改用对象池复用 + context.WithTimeout”。某些技术方案可能是你的禁区，直接写入即可。

第三类是决策惯性。例如：“当涉及用户身份验证时，默认采用 JWT + Bearer Token 方案，且必须与现有 AuthZ Service 兼容”。这能让 CodeBuddy 在面临选择时自动倾向你的常用方案。

需要特别提醒：SOUL.md 一旦写入，就会永久影响该目录下所有 CodeBuddy 会话的行为逻辑。删除后，历史记忆无法恢复。

绑定USER.md：固化你的开发者画像

USER.md 的作用是存储你作为开发者的个性化信息。它会被自动注入到每次对话的上下文，让 AI 记住“你是谁”。

在项目根目录创建 USER.md，填入真实、具体、可验证的信息：

• 姓名或昵称（非必填，但建议填写，便于调试识别）
• 主力语言栈（例如：Go 1.22 + React 18 + PostgreSQL 15）
• 偏好工具链（例如：VS Code + Docker Desktop + gh CLI）
• 近期重点任务（例如：正在重构订单履约服务，目标 Q3 上线 Saga 模式）

这里有一个关键原则：不要写模糊描述。像“熟悉前端”这种表述太笼统，应写成“能手写 React Server Components，拒绝使用 useEffect 模拟生命周期”——越具体越好。

完成这一步后，下次运行 codebuddy 时，它会主动询问：“上次我们讨论过 Saga 补偿事务的幂等设计，这次需要继续完善重试策略吗？”这就是固化画像带来的效果。

配置CODEBUDDY.md：接管全局行为开关

CODEBUDDY.md 是控制台级别的配置中枢，决定 CodeBuddy 如何与你协作。这里有三种常见配置方法：

方法一：启用 Plan 模式并锁定模型。在文件中写入：

permission-mode: plan
default-model: deepseek-v3.1
text-to-image-model: flux-dev

这样做的好处是，每次操作前都会生成一个可审查的执行计划，并强制使用指定模型处理代码任务。

方法二：激活 Skills 自动加载。添加：

skills:
  - ./skills/authz
  - ./skills/db-migration

需要确保这些路径下存在合法的 SKILL.md 文件，否则 CodeBuddy 会跳过加载，且不报错。

方法三：禁用默认网络访问。加入 disable-network: true，此时所有依赖外部 API 的操作（比如查 npm 包版本、拉取 GitHub 模板）都会被拦截，强制本地化执行。

初始化daily-memories：让每次对话沉淀为长期记忆

CodeBuddy 默认每天生成一个临时记忆快照，存放在 daily-memories/2026-07-09.md 这样的路径下。但要让它真正发挥作用，需要几个步骤：

第一步，手动创建该文件，写入今日关键决策摘要。例如：

“2026-07-09｜订单服务拆分决议：将 payment-service 独立部署，保留与 order-service 的 gRPC 同步调用，取消 Kafka 事件广播。”

第二步，运行 codebuddy doctor --memory-scan 触发记忆索引重建。

第三步，在后续会话中直接说“回顾昨天关于 payment-service 的拆分方案”，它就能从 daily-memories 中精准定位并复述。

还有一点需要注意：daily-memories 不会自动归档。需要每月手动将确认无误的内容合并进 MEMORY.md，才算完成一次完整的记忆沉淀。