Hua/Hua.Todo
1
0
Fork 0
Code Issues Wiki Activity
Files
aacc56e95268777d32366a8bbd18df0db7b4d318
Hua.Todo/.trae/rules/全局/01-智能体记忆.md
T
ShaoHua 8b0b2cb197 docs: 新增AI沟通记录规范，清理旧规则文件引用 
- 新增 08-AI沟通记录规范.md，约定沟通记录存储结构与生命周期

- 新增 docs/AI沟通记录/ 目录及首批沟通记录

- 删除已迁移的旧规则文件 commenting.md、documentation_sync.md

- 更新索引与智能体记忆文件
2026-06-16 00:22:59 +08:00

3.0 KiB
Raw Blame History

智能体记忆与规范同步规则（必须遵守）

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

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

记忆存储

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

规范同步

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

文件命名规则（强制）

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

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

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

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

实现要求

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

路径规范

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