ShaoHua
9223ceca50
- 规则重组：全局/ 下 8 个规则合并为 6 个（01+02→01，05+06→04），序号顺延 - 新增项目规则 05-多入口功能同步规范（UI/语音入口覆盖检查） - 新增 MCP 服务基础设施：Mcp/ 目录（DI 注册、端点扩展、动态工具描述符）、单元测试 - v1.3.0 工单文档：03 系列（会议任务拆分）、04（富文本描述与附件管理） - MCP 接口与前端集成指南：docs/manual/08、09
4.8 KiB
4.8 KiB
.trae 目录索引
本文件是
.trae/目录的总入口，描述各子目录与关键文件的职责，便于智能体与开发者快速定位。关于 TRAE 官方"全局规则 vs 项目规则"：TRAE IDE 的"全局规则"由设置中心保存到用户级、不入仓；本仓库
.trae/rules/下的所有内容（含子目录）都会被 TRAE 识别为项目规则。下面的子目录全局/与项目/是项目内部的语义分组，不改变 TRAE 的加载语义。子目录嵌套深度受 TRAE 官方限制：
.trae/rules/下最多 3 层嵌套。文件命名约定：每个子目录内文件以
NN-名称.md格式编号（两位数字），编号反映阅读优先级 / 依赖顺序。索引文件本身不带序号。⚠️ 新增文件必须遵守命名规则：序号 = 当前目录最大值 + 1，不得跳号或重复，并需同步更新本索引文件中的对应章节。详见 01-记忆与存储规范.md。
⚠️ 任务完成后清理义务：研发工单验收完成后，必须清理
coordination/中的临时记录行（保留文件与表头），并按需追加memory/的长期记忆条目。详见 05-并行窗口冲突规约.md 与 01-记忆与存储规范.md。
整体结构
.trae/
├── 索引.md ← 本文件（目录入口）
├── rules/
│ ├── 全局/ ← 通用规范（跨项目可复用的方法论）
│ └── 项目/ ← Hua.Todo 专属（业务/架构/状态/数据）
├── memory/ ← 长期记忆数据（决策、对话产物）
└── coordination/ ← 多 solo 窗口协作目录（运行时登记表）
rules/全局/ — 通用规范（与具体项目无关）
| 文件 | 职责 |
|---|---|
| 01-记忆与存储规范.md | 智能体记忆/存储/规范同步机制 & .trae/memory/ 使用方式 & 文件命名规则（含序号速查表） |
| 02-注释规范.md | C# / TypeScript / Vue 代码注释要求 |
| 03-文档同步规范.md | 代码变更同步 README/docs 的硬性要求 |
| 04-研发工单全流程规范.md | 研发工单术语定义 + 拆分输出规范 + 新增工单约束（合并原 05/06/09） |
| 05-并行窗口冲突规约.md | 并行 solo 窗口下的 Touch List / Writer / 绿线策略 |
| 06-AI沟通记录规范.md | 用户与智能体沟通记录的存储目录、序号管理与内容规范 |
rules/项目/ — Hua.Todo 专属
| 文件 | 职责 |
|---|---|
| 01-项目架构.md | src/ 五大项目划分、依赖方向、两种运行模式 |
| 02-业务命名规范.md | Task/SubTask/TaskEntity 等代码标识符与"研发工单"边界 |
| 03-数据模型与迁移约束.md | EF Core 实体清单、迁移历史、改 schema 纪律 |
| 04-即时状态记忆.md | 当前活跃版本 / 工单状态快照 / 临时决策 / 未完结事项 |
| 05-多入口功能同步规范.md | 新增功能时必须同步确认 UI 入口与语音控制入口的覆盖情况 |
memory/ — 长期记忆
- 用途：长期沉淀的对话产物、关键开发决策、不再频繁更新的项目快照
- 与"项目即时状态"的边界：04-即时状态记忆.md 偏当前快照、更新频率高；
memory/偏长期保留 - 维护规约：详见 01-记忆与存储规范.md
- 文件：
- 01-project_memory.md：依赖小版本号、历史决策、变更时间轴
coordination/ — 多窗口协作运行时目录
- 用途：并行 solo 窗口下的"谁在改什么"登记表与共享文件清单（运行时数据，非冷文档）
- 协作协议详见 05-并行窗口冲突规约.md
- 文件：
- 00-README.md：目录约定
- 01-ownership.md：文件/目录所有权（Writer）登记
- 02-shared-files.md：本阶段共享文件清单（Integrator 维护）
handoff/、wip/：差异建议交接 / 编译中途状态（按需新建）