链路问题深度分析文档工作流

给定一个项目和一个研究主题（观察到的现象/问题），沿「范围冻结 → 链路走查 → 三分支验证 → 证据合流 → HTML 撰写 → 事实终检 → 交付对账」产出一份证据落地、可复现的单文件 HTML 深度分析文档。文档同时服务两类读者：不熟悉技术细节的产品/管理同学，和需要核对每条证据的工程师。

最终会得到什么

• 一份单文件 report.html：现象疑问句标题、TL;DR、名词速查、SVG 链路图解、分层根因、裁定表、实验数据、对照组、修复方向表、证据索引附录；深浅色主题自适应、零外部依赖
• 全程中间产物：调研笔记、逐条裁定表、受控实验报告、对照组分析、分级证据账本
• 事实终检记录与交付对账清单，保证每个数字可复现、每条论断有出处

节点与模型

9 节点 DAG；链路走查之后「假设裁定 / 受控实验 / 对照组分析」三分支真实并行，在证据合流处合并。所有节点均为文本推理节点，不绑定特定模型；推荐在带代码检索与命令执行能力的 Agent 环境（如 Claude Code）中运行，模型选强推理档。

| 节点 | 职责 | 产物 |

|---|---|---|

| 范围冻结 | 复述现象、圈定仓库、版本锚定 | scope.md |

| 链路走查 | 端到端取证，论断全部带出处 | research-notes.md |

| 假设裁定 ∥ | 与一手证据逐条对照给裁定 | verdicts.md |

| 受控实验 ∥ | 可证伪量化实验（单变量 + 独立裁判 + 正反对照） | experiment-report.md |

| 对照组分析 ∥ | 解释「准的模块」为什么准 | contrast.md |

| 证据合流 | 分级证据账本、误判澄清、修复草案 | evidence-ledger.md |

| 文档撰写 | 单文件 HTML 深度分析文档 | report.html |

| 事实终检 | 数字复现 / 出处对应 / 语气校准 | factcheck.md + report.html |

| 交付清单 | 结构与视觉对账，缺失不得宣称完成 | delivery.md |

变量与复跑

• 项目与仓库（多行）：仓库列表与架构一句话
• 研究主题（多行）：观察到的现象/问题，将成为文档标题
• 已有分析或指控（多行，可留空）：留空时裁定分支改为裁定走查中自建的根因假设

三个变量都只出现在「范围冻结」入口节点；换项目/换主题只需替换变量后整链复跑。注意：工作流类型的 {{变量}} 在网页端不渲染表单，使用时手动替换。

降级行为

• 无法访问项目代码：范围冻结节点列出所需材料清单并停止，不凭记忆编造链路
• 环境不允许实测：受控实验节点只输出实验设计，相关结论降级为「工程推断（未实测）」，禁止编造数据
• 缺某章素材：文档撰写节点省略该章并在页脚注明，不填充编造内容

产物目录

scope.md · research-notes.md · verdicts.md · experiment-report.md · contrast.md · evidence-ledger.md · report.html · factcheck.md · delivery.md