zcbot/skills/analyze/references/issue_tree_patterns.md

94 lines
4.0 KiB
Markdown

# Issue Tree 拆分模板(MECE)
MECE = Mutually Exclusive, Collectively Exhaustive(各子项互不重叠,合起来覆盖全部)。拆得好的 issue tree 看一眼就知道哪些叶子是关键路径。
## 三个常用维度(按场景选一个)
### 模板 A: 机理-现象-工艺(建材最常用,默认选)
适合:**性能问题 / 缺陷分析 / 新材料探索**
```
根问题
├── 机理层(为什么会这样?)
│ ├── 化学组成 / 物相
│ ├── 微观结构 / 形貌
│ └── 界面 / 缺陷
├── 现象层(看到了什么?)
│ ├── 宏观性能(强度 / 韧性 / 耐久性 / 热学 / 电学)
│ ├── 表观特征(外观 / 颜色 / 开裂模式)
│ └── 时间演化(早期 / 中期 / 长期)
└── 工艺层(怎么造出来的?)
├── 原料(组成 / 纯度 / 粒度)
├── 配料 / 混合
├── 成型 / 烧成 / 养护
└── 后处理 / 检测
```
### 模板 B: 输入-过程-输出(适合系统性问题)
适合:**生产线问题 / 工艺整体优化 / 质量管控**
```
根问题
├── 输入(物料 / 能源 / 信息)
├── 过程(单元操作 1, 2, 3, ...)
└── 输出(主产品 / 副产品 / 排放 / 废物)
```
### 模板 C: 材料-工艺-装备-检测(适合工程问题)
适合:**装备改造 / 检测方法开发 / 工艺定型**
```
根问题
├── 材料(配方 / 原料)
├── 工艺(参数 / 流程)
├── 装备(设备 / 工装 / 模具)
└── 检测(标准 / 仪器 / 取样)
```
## 深度建议
- **2 层是底限**(1 层等于没拆)
- **3 层是甜蜜区**(根问题 → 大类 → 具体子问题,5-10 个叶子)
- **4 层只在叶子节点本身复杂时分**(且只分那个叶子,别全树都 4 层)
过深的 tree 模型容易堆细节、用户也读不下去。**宁可拆完发现树不够,再补一支,也别一上来 4 层全开。**
## 叶子节点标注规范
每个叶子节点要带这三个 tag,合写在中括号里:`[<类型> / <优先级> / <能力描述>]`
| Tag | 取值 | 怎么判 |
|---|---|---|
| **类型** | 根因 / 创新 / 优化 | 根因 = "为什么 X 异常";创新 = "怎么换条新路";优化 = "在已知路径上调参找最优" |
| **优先级** | 高 / 中 / 低 | 高 = 是当前瓶颈 + 解决后收益大;中 = 解决了有改善但不致命;低 = 远期 / 边缘问题 |
| **能力** | 一句话动词短语 | "查近 5 年综述"、"XRD + Rietveld 精修算物相含量"、"DoE 拟合响应面"、"SEM 看形貌"... **不写 skill 名** |
## 示例:早强问题拆解(模板 A)
```
P42.5 早强偏低
├── 机理层
│ ├── [根因 / 高 / XRD + Rietveld 精修算 C3S/C2S 比例] 熟料 C3S 比例是否偏低
│ ├── [根因 / 高 / SEM 看水化早期 CSH 形貌 + EDS 测 Ca/Si] 水化早期产物形貌异常
│ └── [根因 / 中 / 查文献综述助磨剂对水化影响] 助磨剂残留是否毒化水化
├── 现象层
│ ├── [优化 / 中 / DoE 调比表面积测早强响应] 比表面积与早强关系曲线
│ └── [优化 / 低 / 跟踪生产记录方差分析] 不同批次早强方差是否显著
└── 工艺层
├── [优化 / 高 / 跟班记录工艺参数 + 测游离 CaO] 煅烧温度与游离 CaO 关系
└── [创新 / 中 / 查文献综述纳米 CaCO3 晶种] 引入纳米晶种早强方案
```
## 反模式
- 拆出的叶子节点之间有重叠(违反 MECE 的 ME)—— 例:既有"原料 SiO2 含量"又有"配料 SiO2 比例",合并
- 漏掉显然该有的分支(违反 MECE 的 CE)—— 例:讨论强度问题但漏了"养护条件"
- 叶子标"用 research skill"/"用 stats_ml skill" —— 写能力描述,不写 skill 名(改名要回来改)
- 叶子优先级全标"高" —— 假装 MECE,等于没排
- 拆到 4 层才发现叶子全是 `<TODO>` —— 说明 PICO 阶段问题没问清,回阶段一
- 拆完 tree 自己开始查文献做分析 —— analyze 只拆,执行交棒下游
- mermaid 中文节点名带特殊字符不转义(逗号 / 引号 / 括号) —— 节点名用方括号包,内部避免符号或转义