CodeBuddy通过SOUL.md、USER.md、CODEBUDDY.md和daily-memories四类文件构建持久化智能体：SOUL.md定义行为内核，USER.md固化开发者画像，CODEBUDDY.md接管全局开关，daily-memories沉淀每日决策。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让CodeBuddy不再只是执行指令的工具，而是真正理解你项目风格、记住你偏好的技术选型、甚至延续上一次未完成的架构决策——这需要给它注入一个可持久、可演进、可复用的编程灵魂。
构建SOUL.md：定义智能体的行为内核
SOUL.md是CodeBuddy记忆系统的“灵魂文件”，它不参与日常对话，但会在每次会话启动时被自动加载为系统提示词的顶层约束。
在项目根目录创建SOUL.md文件，内容必须以YAML Frontmatter开头：
```yaml
name: 后端微服务架构师
description: 专注高可用、可观测、零信任安全的Go微服务实践，偏好Kitex+ETCD+OpenTelemetry栈
```
紧接着写入三类核心指令：
① 风格契约：例如“所有HTTP错误响应必须返回RFC 7807标准Problem Detail格式，status字段严格匹配HTTP状态码”；
② 技术红线：例如“禁止使用goroutine leak风险高的sync.Pool，改用对象池复用+context.WithTimeout”；
③ 决策惯性：例如“当涉及用户身份验证时，默认采用JWT+Bear Token方案，且必须与现有AuthZ Service兼容”。
【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补偿事务的幂等设计，这次需要继续完善重试策略吗？”
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
配置CODEBUDDY.md：接管全局行为开关
CODEBUDDY.md是控制台级配置中枢，决定CodeBuddy如何与你协作。
方法一：启用Plan模式并锁定模型
在文件中写入：
```yaml
permission-mode: plan
default-model: deepseek-v3.1
text-to-image-model: flux-dev
```
这会让每次操作前都生成可审查的执行计划，并强制使用指定模型处理代码任务。
方法二：激活Skills自动加载
添加：
```yaml
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。
