Aikodoc
工作台使用

血缘与影响分析

改一行 BRD 的时候,自动告诉你 PRD 哪几段、技术方案哪一节会被牵动

文档之间是有引用关系的。BRD 里的「优先级」决定 PRD 里哪些功能先做;BRD 里的「业务对象」会被技术方案里的「领域模型」一一对应;PRD 里的「3.1.1.1 OCR 识别登记」会被测试用例里的「TC-OCR-01」校验。

这些引用关系在传统文档里是隐性的——只活在写文档的人脑子里。改一处之后哪些地方要跟着改?只能靠 review 时记得 + 群里 @ + 邮件提醒,漏了就漏了。

Aiko Studio 把这层关系显式建模:每一次跨文档的引用都被记录,改动的时候自动告诉你影响范围。这页讲它怎么帮你。

1. 你会在三个时刻看到血缘

① 写文档时——这一段被谁引用了?

在 BRD 章节顶部有一个「关系」按钮,旁边带数字徽标:

关系 2

意思是这个章节已经被 2 处下游内容引用。点开会展开一个面板:

被引用:
├ PRD · 车辆管理产品需求 · 3.1 车辆排队登记
└ 技术方案 · 排队系统架构 · 4.2 业务实体模型

价值:你在改这段之前先知道——「哦,这段我改了,PRD 第 3.1 节和技术方案第 4.2 节得同步看一下」。再不会出现 PRD 里写着「按司机身份证排队」、BRD 早就改成「按车牌排队」却没人发现的情况。

② 改完之后——Copilot 主动告诉你影响

在 Copilot 对话里改完一个字段,AI 会自动调用「影响查询」,给你一段总结:

✓ 已更新 BRD §1 业务痛点:把"司机平均等待 2 小时"改为"高峰期 3 小时"。

这次改动可能影响

  • PRD §3.1.1.3 短信通知发送 —— 触发条件里写的也是「等待 ≥ 2 小时」,需要同步
  • PRD §4 数据指标 —— "等待时长 SLA" 指标的基线值要更新

价值:不需要你自己记得"我改了 X,得去看看 Y"。改完 AI 立刻告诉你全集,你顺着列表挨个处理就行。

③ 接手别人文档时——一眼看清结构

进入一份从没看过的 PRD,左下角点「这份文档的引用关系」可以打开血缘视图

  • 这份 PRD 上游是哪份 BRD?哪些章节引用了 BRD 哪些段?
  • 这份 PRD 下游有哪些技术方案 / 测试用例 / Skill 在引用?
  • 哪些章节是孤立的(没人引用,可能是过时内容)?

价值:以前接手一份不熟的文档,至少要花半天读上下游;现在 30 秒看清整张关系图,知道哪里是"主干"、哪里是"枝叶"。

2. 引用是怎么被记录的

血缘关系不需要你手动维护——大多数时候是自动建立的:

  • Copilot 写作时:AI 在写 PRD 第 3.1 节时显式 read_entity 了 BRD 的 QUEUE_REG 模块,这条引用就被记录
  • 手动 @ 引用:在 Copilot 输入框打 @,弹出当前项目的章节列表,选一个引用进来时记录
  • 跨文档插入:在章节里输入 @ 选文档+章节作为内嵌引用块时记录

Skill 也算一种引用源:某个 Skill 在生成内容时读了 BRD 的某些字段,这层依赖也被记录——所以你改 Skill 的提示词时,也能查"这个 Skill 影响哪些下游文档"。

3. 影响通知不会打扰你

  • 静默记录:所有引用关系只在你点开「关系」按钮或问 Copilot 时才显式呈现,平时不会弹窗打扰
  • 改动后才提示:只有当你真的改了一个被下游引用的字段,AI 才会主动给一段影响汇总
  • 支持 waiver:明确知道这次改动不影响下游(比如只是改错别字),可以一键标「忽略本次影响」,记录下来不再提示

4. 这能帮你团队做对什么

场景没血缘的痛苦Aiko Studio 的解法
业务方改了一行需求半个月后测试发现 PRD 没同步改的当下 Copilot 提示「PRD §3.1 有相同条件」
新人接手项目读 5 份文档花 2 天才看清关系一张血缘图 30 秒看清主干
Review 跨文档变更评审者要翻多个文档对照自动生成"本次改动影响清单"
文档过时检测没人主动检查谁过时了「孤立章节」自动标记,定期清理
重构需求结构改一处怕牵动一片改之前先看「关系 N」徽标知道牵动范围

下一步

On this page