feat(mcp): 新增 MCP 服务基础设施,重构规则文件序号,新增 v1.3.0 工单文档
- 规则重组:全局/ 下 8 个规则合并为 6 个(01+02→01,05+06→04),序号顺延 - 新增项目规则 05-多入口功能同步规范(UI/语音入口覆盖检查) - 新增 MCP 服务基础设施:Mcp/ 目录(DI 注册、端点扩展、动态工具描述符)、单元测试 - v1.3.0 工单文档:03 系列(会议任务拆分)、04(富文本描述与附件管理) - MCP 接口与前端集成指南:docs/manual/08、09
This commit is contained in:
@@ -0,0 +1,82 @@
|
||||
# 智能体记忆与存储规范(必须遵守)
|
||||
|
||||
> 适用范围:本规则属于 **全局规则**(语义层面跨项目可复用),关注智能体如何维护记忆、存储与同步规范,与具体项目业务无关。
|
||||
>
|
||||
> `.trae/` 整体目录结构与各子目录职责见 [.trae/索引.md](../../索引.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](../项目/04-即时状态记忆.md),不进 `memory/`
|
||||
- **不删长期内容**:除非内容已被证伪或过时,否则不删除既有条目;过时内容用"已废弃 / 已被 XX 取代"的形式保留语义而非物理删除
|
||||
- **新增文件序号化**:当主题足够独立时新建 `NN-名称.md`(序号紧接当前最大值),并在 [.trae/索引.md](../../索引.md) 的 `memory/` 章节同步追加链接
|
||||
|
||||
### 1.5 访问权限
|
||||
|
||||
- 记忆文件仅供开发团队内部参考使用
|
||||
- 确保记忆文件中的敏感信息得到适当保护
|
||||
- 遵循项目的版本控制和代码管理规范
|
||||
|
||||
## 二、规范同步
|
||||
|
||||
- 每次对话中涉及到的语法或规范相关内容,必须同步整理到 `.trae/rules` 目录下的对应文件中
|
||||
- **通用规范**(注释、文档同步、工单流程、并行冲突)→ 写入 `.trae/rules/全局/`
|
||||
- **项目专属**(业务命名、架构边界、数据模型、即时状态)→ 写入 `.trae/rules/项目/`
|
||||
- 若涉及到新的规范或规则,应创建新的规则文件进行记录
|
||||
- 规范同步应及时、准确,确保规则文件能真实反映当前项目的编码规范和最佳实践
|
||||
|
||||
## 三、文件命名规则(强制)
|
||||
|
||||
`.trae/` 下所有子目录中**新增的文件必须沿用 `NN-名称.md` 序号格式**,否则视为不合规:
|
||||
|
||||
- **格式**:两位数字 + 连字符 + 中文/英文名称 + `.md`,例如 `06-XXX规范.md`
|
||||
- **序号取值**:紧接当前目录已有最大序号 +1,不得跳号、不得重复
|
||||
- **入口/索引文件例外**:`.trae/索引.md` 这类目录入口文件不带序号
|
||||
- **重排禁止**:除非整体重构,否则不得重排已有文件的序号;新增只能追加在末尾
|
||||
- **同步更新索引**:每次新增文件后,必须在 [.trae/索引.md](../../索引.md) 的对应章节同步追加该文件的链接与一句话职责说明
|
||||
- **跨目录创建**:在 `coordination/`、`memory/` 下新增文件时同样适用本规则
|
||||
|
||||
### 各子目录当前最大序号速查
|
||||
|
||||
| 子目录 | 当前最大序号 | 下一个可用 |
|
||||
|---|---|---|
|
||||
| `rules/全局/` | 06 | 07 |
|
||||
| `rules/项目/` | 05 | 06 |
|
||||
| `memory/` | 01 | 02 |
|
||||
| `coordination/` | 02 | 03 |
|
||||
|
||||
## 四、实现要求
|
||||
|
||||
- 智能体应定期检查并更新规则文件,确保其与项目实际情况保持一致
|
||||
- 当发现规范冲突或需要调整时,应及时记录并通知相关人员
|
||||
- 记忆存储和规范同步应作为智能体的核心功能,贯穿于整个开发过程
|
||||
|
||||
## 五、路径规范
|
||||
|
||||
- 所有 Markdown 文档中不应使用绝对路径,应使用相对路径
|
||||
- 相对路径应以项目根目录为基准,例如 `.trae/memory` 而非绝对路径
|
||||
- 确保路径格式统一,使用正斜杠 (`/`) 作为路径分隔符,避免使用反斜杠 (`\`)
|
||||
- 智能体在生成或修改文档时,应自动检查并替换绝对路径为相对路径
|
||||
Reference in New Issue
Block a user