听写助手对话记录：agents.md 迁移与需求文档重构¶
记录编号：DLG-20260804-06 日期：2026-08-04 智能体：听写（文档编写助手） 参与方：项目发起人（用户）、听写 沟通渠道：AI 助手对话 主题：agents.md 迁移至项目根目录、需求文档独立子目录、需求文档结构重构（业务级按服务分块、执行级按干系方×功能组分块）
一、用户需求¶
用户提出四项结构调整需求：
- agents.md 迁移：从
docs/转到项目根目录。 - 需求文档独立子目录：创建专门的子目录存放需求文档，后续可能分为多个文档。
- 业务级需求按服务分块：同时存在综合跨服务的需求。
- 执行级需求按干系方×功能组分块。
二、工作过程记录¶
步骤 1：迁移 agents.md 至项目根目录¶
原位置：docs/agents.md
新位置：agents.md
路径引用更新规则：
| 文件位置 | 引用 agents.md | 引用需求分析 |
|---|---|---|
| 根目录 (agents.md) | agents.md |
docs/需求分析/README.md |
| docs/ 下 (术语表.md) | ../agents.md |
需求分析/README.md |
| docs/子目录 (报价服务/) | ../../agents.md |
../需求分析/README.md |
| docs/子目录 (工作日志/) | ../../agents.md |
— |
步骤 2：创建需求文档独立子目录¶
原位置：docs/需求分析.md
新位置：docs/需求分析/README.md
步骤 3：重构需求文档——业务级按服务分块¶
原结构：§3 业务级需求（扁平结构） 新结构： - §3.1 QSV 报价服务需求（核心功能需求 + 定价原则 + 业务约束） - §3.2 CPT 客户项目跟踪服务需求（核心功能需求 + 业务约束） - §3.3 综合跨服务需求（品类范围 + 场景策略 + 业务风险）
步骤 4：重构需求文档——执行级按干系方×功能组分块¶
干系方需求矩阵（§4.2）：
| 干系方 | 简称 | 核心需求 |
|---|---|---|
| 客户 | CST | 透明报价、订单状态、回访问卷等 |
| 师傅 | WKR | 信息采集清单、拍照打卡、服务报告等 |
| 配送人员 | DLV | 扫码打卡、异常上报、签收同步等 |
| 平台运营 | OPR | 完整性校验、异常预警、监控看板等 |
| 合作方 | PRT | 批量导入、状态同步、对账报表等 |
功能组需求矩阵（§4.3）：
| 功能组 | 简称 | 核心功能 |
|---|---|---|
| 报价 | QTE | 基础费率、系数计算、明细展示等 |
| 订单 | ORD | 下单、订单管理、批量导入等 |
| 派单 | DSP | 师傅匹配、派单通知、调整等 |
| 跟踪 | TRK | 状态流转、完整性校验、时间线等 |
| 验收 | ACC | 验收确认、整改返工、照片归档等 |
| 回访 | FUP | 回访问卷、满意度评分、反馈归档等 |
| 结算 | PAY | 对账报表、师傅结算、发票管理等 |
步骤 5：更新所有文档交叉引用¶
更新以下文档的路径引用： - 术语表.md、报价服务/README.md、报价模型设计.md - 客户项目跟踪服务/README.md、技术文档/README.md - 工作日志/README.md
三、结论与产出¶
本次对话产出物清单¶
| 序号 | 产出物 | 位置 | 状态 |
|---|---|---|---|
| 1 | agents.md V4.0（迁移至根目录） | agents.md | 已完成 |
| 2 | 需求分析 README V2.0（独立子目录） | docs/需求分析/README.md | 已完成 |
| 3 | 术语表.md（路径引用更新） | docs/术语表.md | 已完成 |
| 4 | 报价服务 README（路径引用更新） | docs/报价服务/README.md | 已完成 |
| 5 | 报价模型设计（路径引用更新） | docs/报价服务/报价模型设计.md | 已完成 |
| 6 | 客户项目跟踪服务 README（路径引用更新） | docs/客户项目跟踪服务/README.md | 已完成 |
| 7 | 技术文档 README（路径引用更新） | docs/技术文档/README.md | 已完成 |
| 8 | 工作日志 README（路径引用更新） | docs/工作日志/README.md | 已完成 |
关键决策与说明¶
- agents.md 根目录定位：作为项目入口文档，放在根目录便于协作者快速发现。
- 需求文档独立子目录：
docs/需求分析/下预留空间，后续可拆分为多个子文档（如 QSV 需求、CPT 需求、跨服务需求等）。 - 业务级分块策略：按服务（QSV/CPT）分块 + 综合跨服务板块，既体现服务专属需求，又处理共享需求。
- 执行级分块策略：按干系方×功能组矩阵组织，便于从不同视角查看需求。
当前文档体系总览¶
hk2026/ 项目根目录
├── agents.md PMG（项目管理制度）
├── docs/
│ ├── 需求分析/ RQD（业务需求文档）
│ │ └── README.md
│ ├── 术语表.md GLY
│ ├── 报价服务/ QSV
│ ├── 客户项目跟踪服务/ CPT
│ ├── 技术文档/ TND
│ └── 工作日志/ WLG
└── ref/ 参考资料库
四、待办事项¶
| 序号 | 待办 | 负责人 | 截止时间 | 状态 |
|---|---|---|---|---|
| 1 | 审阅 RQD V2.0 的干系方需求矩阵与功能组需求矩阵 | PO/TL | 待定 | 待确认 |
| 2 | 根据需求拆解 QSV 和 CPT 的详细功能需求文档 | PO | 待定 | 待办 |
| 3 | 各干系方需求的优先级确认 | BO/OL | 待定 | 待办 |
| 4 | Git 提交当前所有文档变更 | DT | 待定 | 待办 |
五、备注¶
- 本记录由听写根据对话全过程整理。
- 需求文档子目录
docs/需求分析/预留扩展空间，后续可拆分 QSV 需求、CPT 需求等子文档。 - 所有相对路径引用已验证正确。