跳转至

听写助手对话记录:文档关联关系图分架构拆分

记录编号:DLG-20260804-15 日期:2026-08-04 智能体:听写(DT) 参与方:项目发起人(用户)、听写 沟通渠道:AI 助手对话 主题:agents.md 文档关联关系图拆分为「业务设计架构」和「项目管理架构」两个独立 Mermaid 图


一、用户需求

用户反馈 V6.0 的「文档关联关系图」节点和关系线太多太杂,要求拆分:

  1. 业务设计架构图:包含 RQD、CPT、QMD、TND 全部文档以及关联线条
  2. 项目管理架构图:包含剩余的 PMG、GLY、ARC、WLG、PJM 全部文件以及关系线条
  3. 这样看起来更容易些

二、工作过程记录

步骤 1:设计拆分策略与跨架构边界

原单图 16 个文档节点 × 24 条关系线 × 12 条全局虚线,拆分后:

架构 节点数 主关系线 跨架构连接数 核心归属
项目管理架构(PM) 5 个 R1/R3/R4/R5/R7(5 条) 2 出 + 2 全局 PMG、PJM、GLY、WLG、ARC
业务设计架构(BIZ) 11 个 R8~R24(17 条) 2 入 + 2 全局 RQD(4)+ QSV/CPT(5)+ TND(2)

跨架构连接不重复画,统一规则: - 管理架构侧:用虚线菱形占位锚点 + ★跨架构 标注 → 标明"到业务架构哪里" - 业务架构侧:用虚线菱形占位锚点 + ★跨架构入←管理架构 标注 → 标明"从管理架构哪条关系来" - 避免同一条关系线被绘制两次

步骤 2:跨架构连接映射表

关系编号 管理架构侧(出) 业务架构侧(入) 说明
R2 PMG -.→ BIZ_RQD ★跨架构 MG_R2 ★跨架构入 -.→ RQD PMG 入口 → 业务需求目录
R6 PJM -.→ BIZ_RQDO ★跨架构 MG_R6 ★跨架构入 -.→ RQD-O PJM RACI 角色 → 执行级需求干系方
GLY 全局 GLY -.→ BIZ_ALL ★跨架构→业务全部 MG_GLY ★跨架构入 -.→ 6 个 BIZ 节点 术语支撑所有业务文档
WLG 全局 WLG -.→ BIZ_ALL ★跨架构→业务 MG_WLG ★跨架构入 -.→ 3 个 BIZ 节点 变更记录追溯业务文档

步骤 3:拆分后两个 Mermaid 图写入 agents.md

图 1 - 项目管理架构(PM) 特色: - 节点 5 个(PMG ★入口 / GLY ★全局术语源 / WLG ★全局过程追溯 标识高亮) - 着色:浅沙金(品牌辅色) - 跨架构锚点:虚线菱形边框 + 浅背景,视觉上区分于真节点 - GLY/WLG 分别分两边:「管理内支撑」和「跨架构→业务全局」各一条路径

图 2 - 业务设计架构(BIZ) 特色: - 4 层分区配色:深墨绿(需求)→ 青绿(服务)→ 蓝色(技术),符合阅读流 - 顶部跨架构入边 4 个锚点,菱形虚线框 - R21(CPT-D → QSV-D/QMD)加粗,突出核心数据闭环反哺 - 17 条业务实线(R8~R24)清晰呈现「目录→子文档」+「战略→业务→执行」+「需求驱动→服务内部→技术落地」全链路

步骤 4:关系详情表扩展新增「所属架构」列

原表 5 列(关系编号/源文档/→目标文档/关系类型/详细说明) → 扩展为 7 列: 1. 关系编号 2. 所属架构(新增列):管理架构 / 业务架构 / 跨架构(管→业) / 跨架构(全局) 3. 源文档 4. (独立方向列,保证源/目标严格分列,不再出现 "PMG ← GLY" 合并写法) 5. 目标文档 6. 关系类型 7. 详细说明

同步修正原表 3 处双向关系方向一致性问题: - R3 「PMG ← GLY」 统一方向 → 「GLY → PMG」,说明中标注「双向语义」 - R4 「PMG ← WLG」 统一方向 → 「WLG → PMG」,说明中标注「双向语义」 - R7 「ARC ← WLG」 统一方向 → 「WLG → ARC」,说明中标注

步骤 5:版本、快速上手、修订记录同步

  • agents.md 头部版本:V6.0 → V6.1
  • 快速上手步骤 3:原单个「文档关联关系图」链接 → 拆为 「项目管理架构图」+「业务设计架构图」+「详情表」 三个锚点链接
  • 修订记录新增 V6.1 条目,四项修改点

三、结论与产出

本次对话产出物清单

序号 产出物 位置 版本变更
1 agents.md:项目管理架构 Mermaid 图(5 节点) agents.md §架构一 V6.0 → V6.1
2 agents.md:业务设计架构 Mermaid 图(11 节点) agents.md §架构二 V6.0 → V6.1
3 文档关系详情表:新增「所属架构」列 + 源/目标分列规范化 agents.md §详情表 V6.0 → V6.1

修改前后对比

维度 修改前(V6.0 单图) 修改后(V6.1 双架构图)
图数量 1 张 2 张独立 Mermaid
最大节点数 16 个(含管理+业务+技术) 管理侧 5 个 / 业务侧 11 个,各图更聚焦
跨架构线处理 直接实线穿越两个区域,视觉混淆 菱形锚点 + ★跨架构 虚线标注,边界清晰
关系表架构归属 无归属,需阅读者脑补 新增「所属架构」列,6 种分类一目了然
关系方向 R3/R4/R7 用「X ← Y」合并写法,方向不统一 全部改为「源 → 目标」单列,双向在说明中注明

四、关键决策与说明

  1. 为什么不把 R2/R6 完全删除?:即使跨架构,也必须在两端都有视觉暗示,否则会让单看一张图的读者疑惑"RQD 怎么来的?RQD-O 的 RACI 哪里定义的?"
  2. 为什么拆分为 PM/BIZ 而不是 DOC-A/DOC-P 分类?:用户明确要求按"业务设计/项目管理"语义拆分——管理类文档支撑流程,业务设计类文档支撑产品服务,PM/BIZ 名称更贴近团队角色视角
  3. GLY 版本号统一 V4.1:管理架构图中 GLY 节点版本从原 V3.0 更正为实际文档头 V4.1(同步前次 GLY 补充 ARC 后的版本)
  4. 全局支撑仍保留但收敛:原 GLY/WLG 各画 6+5 条虚线到所有业务节点 → 现在用 1 条「BIZ_ALL 锚点」简化管理侧,业务侧仍保留关键入边,不缺失视觉联系

五、待办事项

  • 下次里程碑归档(ARV-V1.1 起),同步新版分架构的 agents.md
  • 如果后续新增第 3 类架构(如代码开发架构 Dev),沿用「跨架构锚点」规范

六、修订记录

版本 日期 修订人 修订内容
V1.0 2026-08-04 DT 创建

本记录由听写根据对话全过程整理。