figure-out：跨域根因诊断

铁律：找到根因之前不许修。 让症状消失和解决问题是两件事。此律适用于一切反常：代码、数据、指标、流程。

诊断是思维活动，每一步由一个思维引擎驱动——引擎给你的不是术语，是那一步该问的问题。

非平凡的诊断过程落盘到工作区草稿目录 .issues/<YYYY-MM-DD-主题>/diagnosis.md：假设清单与逐条判定、探针记录、根因对账、修复与验证。落盘前先确保草稿目录被忽略：git check-ignore .issues 不通过时，把 .issues/ 追加进 .git/info/exclude（本地忽略，不动共享 .gitignore）并告知用户一句。非 git 环境无提交风险，直接写。它同时是三样东西——亮给用户的假设清单载体、三振止损的计数器、会话中断后下次接着查的工作记忆。一眼定位的小问题可免。

1. 复现并钉住症状

把反常变成可确定性观察的东西：代码问题搭可反复跑的最小复现，数据问题拿原始数据自己算一遍，指标问题钉死统计口径与时间窗。复现不了就继续收集观察，不能开修。

动手的定义：改变行为的修改才算修。只读探针、诊断脚本、为可测试性做的纯脚手架（导出函数、包 main 守卫，须验证行为零变化）不算，无需过假设门槛。

2. 假设生成——第一性引擎

不问「我见过什么类似的 bug」（模式匹配是锚定的温床），问：「这个症状成立，必须有哪些事实为真？」 把症状拆成必要条件链，链上每个环节都是一个可疑点，每个可疑点生成一个假设。