# 质量标尺 v2（对齐 Hadoop 参考文）

参考金样：`tech-articles/hadoop-ecosystem-deep-dive/hadoop-ecosystem-deep-dive.html`

## 结论（评审）

v1 系列（浅色 shell + Mermaid）在结构上「有大纲」，但相对参考文差距在：

| 维度 | 参考文 | v1 现状 | v2 目标 |
|---|---|---|---|
| 汉字 | ~9060 | 5k–7k | **8500–10000** |
| 视觉 | 深色工程风、hero、sticky TOC | 浅绿轻壳 | **必须复用 premium-shell** |
| 图 | **手绘 SVG diagram-card**（≥3，含读图方式） | 仅 Mermaid | **≥3 SVG diagram-card**；Mermaid 可选补充 |
| 证据 | fact / trap / prod / infer 分级 callout | 笼统「踩坑」 | **四类 callout 齐全** |
| 开场 | scene-box 复合场景对白 | 普通段落 | **必须有 scene-box** |
| 章节 | 8–10 chapter + 丰富 h3 | ~7 part | **8–10 chapter** |
| 权衡 | pro-con-card / 决策矩阵 | 偶发表格 | **≥1 组 grid-2 权衡 + ≥4 表** |
| 语气 | 机制推导 + 条件化结论 + 来源 | 清单感偏强 | **拒绝空泛口号；标注证据等级** |

## 硬性 DoD（重写验收）

1. 输出覆盖：`architect-series/<slug>/index.html`（允许整文件重写）
2. 骨架：从 `_shared/premium-shell.html` 复制 CSS/布局，勿退回浅绿 shell
3. 汉字 **8500–10000**（去掉 HTML/CSS/SVG 文本/代码块后的 CJK）
4. **≥3** 个 `.diagram-card`，内嵌完整 SVG；每个有 `.dc-caption` 写清「读图方式」
5. 开篇 **scene-box**，标注复合场景
6. callout 至少各出现：`fact` / `trap` / `prod` / `infer` 一次
7. **8–10** 个 `section.chapter`（含沉淀章）
8. 文首声明版本假设；文末检查表 + `ref-list`（书 + 官方文档）
9. 禁止 emoji；禁止伪源码行号；性能数字标注为合成/示例除非有来源
10. 资深架构师视角：写「为什么 / 权衡 / 失败窗口」，不是 API 教程

## 并行策略（v2）

| 项 | 值 |
|---|---|
| 并行度 | **2～3**（比 v1 更严；单篇更重） |
| 模型偏好 | 高质量模型优先于快模型 |
| 批次 | 仍 5 批 × 4 篇；批末硬验收字数+SVG+callout |

## 给子 Agent 的 Prompt 要点

- 先通读参考金样前 2 章（结构/callout/SVG 写法），再写目标主题
- 不要「扩写」旧浅色 HTML；**整篇按 premium-shell 重写**
- SVG 用与参考相同的色板（cyan/emerald/amber/violet/rose）与暗底 `#020617`
- 保留 execution-plan 中该任务的风格路由（入口/解释/验证/沉淀）