ShaoHua
8b0b2cb197
- 新增 08-AI沟通记录规范.md，约定沟通记录存储结构与生命周期 - 新增 docs/AI沟通记录/ 目录及首批沟通记录 - 删除已迁移的旧规则文件 commenting.md、documentation_sync.md - 更新索引与智能体记忆文件
78 lines
2.5 KiB
Markdown
78 lines
2.5 KiB
Markdown
# AI沟通记录规范（必须遵守）
|
||
|
||
> 适用范围：本规则属于 **全局规则**（跨项目通用），约束用户与智能体之间沟通记录的存储与管理。
|
||
|
||
## 一、存储结构
|
||
|
||
- AI沟通记录存放在 `docs/AI沟通记录/` 目录下
|
||
- 每次对话生成一个独立的 Markdown 文件，命名格式：`NN-主题摘要.md`（`NN` 为两位序号）
|
||
- 序号从 `01` 开始，每次新建递增 +1，不得跳号或重复
|
||
- 智能体在新建沟通记录时，默认使用当前最大序号 +1
|
||
|
||
## 二、目录结构
|
||
|
||
```
|
||
docs/AI沟通记录/
|
||
├── 01-首次项目分析.md
|
||
├── 02-架构讨论.md
|
||
└── NN-主题摘要.md
|
||
```
|
||
|
||
- 每个文件即一次对话的完整记录
|
||
- 如有附件或补充材料，可在同目录下新建 `NN-主题摘要/` 子文件夹存放
|
||
|
||
## 三、记录内容规范
|
||
|
||
每个沟通记录文件必须包含以下结构：
|
||
|
||
```markdown
|
||
# AI沟通记录：NN-主题摘要
|
||
|
||
- **日期**：YYYY-MM-DD
|
||
- **参与者**：用户、AI 助手
|
||
- **会话序号**：NN
|
||
|
||
## 讨论主题
|
||
[简要描述本次对话的核心议题]
|
||
|
||
## 关键决策
|
||
[记录对话中达成的重要决策]
|
||
|
||
## 待办事项
|
||
[对话中确认的后续行动项]
|
||
|
||
## 详细记录
|
||
### NN-子主题1
|
||
[内容]
|
||
### NN-子主题2
|
||
[内容]
|
||
```
|
||
|
||
- **详细记录中的子主题必须带序号前缀**，格式为 `### NN-子主题名称`（`NN` 为两位序号，从 01 开始）
|
||
- 子主题序号用于精确引用，例如"沟通记录 03 的 02-xxx"
|
||
|
||
## 四、序号管理与引用
|
||
|
||
- 智能体在对话中可通过序号引用历史沟通记录，例如"参见沟通记录 03"
|
||
- 用户也可通过序号要求智能体回顾某次对话内容
|
||
- 序号一旦分配不可变更，即使删除了某个记录文件夹，也不得复用其序号
|
||
|
||
## 五、与记忆系统的边界
|
||
|
||
| 系统 | 用途 | 更新频率 |
|
||
|---|---|---|
|
||
| `docs/AI沟通记录/` | 对话过程与决策的完整记录 | 每次对话新建 |
|
||
| `.trae/memory/` | 长期沉淀的关键决策与经验 | 按需追加 |
|
||
| `.trae/rules/项目/04-即时状态记忆.md` | 当前快照（进度、临时决策） | 高频更新 |
|
||
|
||
- 三者不要重复存放同一份信息
|
||
- `docs/AI沟通记录/` 偏向**对话过程的完整存档**
|
||
- `.trae/memory/` 偏向**长期沉淀的提炼结论**
|
||
|
||
## 六、检查清单
|
||
|
||
1. [ ] 新建沟通记录时，序号是否为当前最大值 +1？
|
||
2. [ ] 文件名是否为 `NN-主题摘要.md` 格式？
|
||
3. [ ] 记录内容是否包含日期、参与者、讨论主题等必要字段？
|
||
4. [ ] 是否与 `.trae/memory/` 和即时状态记忆避免重复存储？
|