ShaoHua
8b0b2cb197
- 新增 08-AI沟通记录规范.md，约定沟通记录存储结构与生命周期 - 新增 docs/AI沟通记录/ 目录及首批沟通记录 - 删除已迁移的旧规则文件 commenting.md、documentation_sync.md - 更新索引与智能体记忆文件
3.0 KiB
3.0 KiB
智能体记忆与规范同步规则（必须遵守）
适用范围：本规则属于 全局规则（语义层面跨项目可复用），关注智能体如何维护记忆与同步规范，与具体项目业务无关。
.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而非绝对路径 - 确保路径格式统一，使用正斜杠 (
/) 作为路径分隔符，避免使用反斜杠 (\) - 智能体在生成或修改文档时，应自动检查并替换绝对路径为相对路径