Hua.Todo/.trae/rules/全局/01-记忆与存储规范.md

智能体记忆与存储规范（必须遵守）

适用范围：本规则属于 全局规则（语义层面跨项目可复用），关注智能体如何维护记忆、存储与同步规范，与具体项目业务无关。

.trae/ 整体目录结构与各子目录职责见 .trae/索引.md，本文件不再重复描述。

一、记忆存储

1.1 存储位置与组织

• 智能体的记忆必须存放在 .trae/memory 文件夹中
• 记忆应按对话日期或主题进行组织，便于后续查询和参考
• 记忆内容应包含对话历史、关键决策、重要代码片段和规范调整等信息
• 项目即时状态（当前实现到哪一步、未完结事项、临时决策快照）应同步写入 .trae/rules/项目/04-即时状态记忆.md，便于其他智能体或开发者快速对齐

1.2 内容规范

• 记忆文件应保持简洁明了，重点记录重要的开发决策和规范变更
• 避免存储冗余信息，只记录对项目有价值的内容
• 定期清理过时的记忆文件，保持存储空间的合理使用

1.3 与"项目即时状态"的边界

• .trae/memory/ 偏向长期保留的对话产物与决策记录
• .trae/rules/项目/04-即时状态记忆.md 偏向当前快照（实现进度、未完结事项），更新频率高
• 二者不要重复存放同一份信息；以"是否需要长期沉淀"为判定标准

1.4 memory/ 生命周期

研发工单验收完成后，对 memory/ 的处理遵循以下原则：

• 追加而非覆盖：将本次工单中产生的、值得长期沉淀的内容（架构决策、关键避坑经验、引入的新依赖与版本）追加到对应文件
• 不存放过程信息：实现进度、待办勾选、临时决策这些短期信息应留在 04-即时状态记忆.md，不进 memory/
• 不删长期内容：除非内容已被证伪或过时，否则不删除既有条目；过时内容用"已废弃 / 已被 XX 取代"的形式保留语义而非物理删除
• 新增文件序号化：当主题足够独立时新建 NN-名称.md（序号紧接当前最大值），并在 .trae/索引.md 的 memory/ 章节同步追加链接

1.5 访问权限

• 记忆文件仅供开发团队内部参考使用
• 确保记忆文件中的敏感信息得到适当保护
• 遵循项目的版本控制和代码管理规范

二、规范同步

• 每次对话中涉及到的语法或规范相关内容，必须同步整理到 .trae/rules 目录下的对应文件中
  • 通用规范（注释、文档同步、工单流程、并行冲突）→ 写入 .trae/rules/全局/
  • 项目专属（业务命名、架构边界、数据模型、即时状态）→ 写入 .trae/rules/项目/
• 若涉及到新的规范或规则，应创建新的规则文件进行记录
• 规范同步应及时、准确，确保规则文件能真实反映当前项目的编码规范和最佳实践

三、文件命名规则（强制）

.trae/ 下所有子目录中新增的文件必须沿用 NN-名称.md 序号格式，否则视为不合规：

• 格式：两位数字 + 连字符 + 中文/英文名称 + .md，例如 06-XXX规范.md
• 序号取值：紧接当前目录已有最大序号 +1，不得跳号、不得重复
• 入口/索引文件例外：.trae/索引.md 这类目录入口文件不带序号
• 重排禁止：除非整体重构，否则不得重排已有文件的序号；新增只能追加在末尾
• 同步更新索引：每次新增文件后，必须在 .trae/索引.md 的对应章节同步追加该文件的链接与一句话职责说明
• 跨目录创建：在 coordination/、memory/ 下新增文件时同样适用本规则

各子目录当前最大序号速查

子目录	当前最大序号	下一个可用
rules/全局/	06	07
rules/项目/	05	06
memory/	01	02
coordination/	02	03

四、实现要求

• 智能体应定期检查并更新规则文件，确保其与项目实际情况保持一致
• 当发现规范冲突或需要调整时，应及时记录并通知相关人员
• 记忆存储和规范同步应作为智能体的核心功能，贯穿于整个开发过程

五、路径规范

• 所有 Markdown 文档中不应使用绝对路径，应使用相对路径
• 相对路径应以项目根目录为基准，例如 .trae/memory 而非绝对路径
• 确保路径格式统一，使用正斜杠 (/) 作为路径分隔符，避免使用反斜杠 (\)
• 智能体在生成或修改文档时，应自动检查并替换绝对路径为相对路径