ShaoHua
cf96c56bed
本次提交完成了多项清理与规范工作： 1. 移除默认管理员硬编码配置与云同步相关代码 2. 简化前端与MAUI端的配置，关闭静态资源托管以外的冗余功能 3. 清理.gitignore与协调目录，移除临时文件与冗余规则 4. 统一项目命名规范，修正包名与版本号 5. 重构后端数据模型，移除ABP审计字段与云同步相关逻辑 6. 简化WebView配置与系统栏样式，移除不必要的平台检测代码 7. 更新文档与规则文件，完善项目规范与版本记录
54 lines
3.0 KiB
Markdown
54 lines
3.0 KiB
Markdown
# 智能体记忆与规范同步规则（必须遵守）
|
||
|
||
> 适用范围：本规则属于 **全局规则**（语义层面跨项目可复用），关注智能体如何维护记忆与同步规范，与具体项目业务无关。
|
||
>
|
||
> `.trae/` 整体目录结构与各子目录职责见 [.trae/索引.md](../../索引.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](../../索引.md) 的对应章节同步追加该文件的链接与一句话职责说明
|
||
- **跨目录创建**：在 `coordination/`、`memory/` 下新增文件时同样适用本规则
|
||
|
||
### 各子目录当前最大序号速查
|
||
|
||
| 子目录 | 当前最大序号 | 下一个可用 |
|
||
|---|---|---|
|
||
| `rules/全局/` | 07 | 08 |
|
||
| `rules/项目/` | 04 | 05 |
|
||
| `memory/` | 01 | 02 |
|
||
| `coordination/` | 02 | 03 |
|
||
|
||
## 实现要求
|
||
|
||
- 智能体应定期检查并更新规则文件，确保其与项目实际情况保持一致
|
||
- 当发现规范冲突或需要调整时，应及时记录并通知相关人员
|
||
- 记忆存储和规范同步应作为智能体的核心功能，贯穿于整个开发过程
|
||
|
||
## 路径规范
|
||
|
||
- 所有 Markdown 文档中不应使用绝对路径，应使用相对路径
|
||
- 相对路径应以项目根目录为基准，例如 `.trae/memory` 而非绝对路径
|
||
- 确保路径格式统一，使用正斜杠 (`/`) 作为路径分隔符，避免使用反斜杠 (`\`)
|
||
- 智能体在生成或修改文档时，应自动检查并替换绝对路径为相对路径
|