# Report Contract

## Contents

1. Default structure
2. Section requirements
3. Writing style
4. Evidence rules
5. Optional PDF delivery
6. Quality bar

## 1. Default Structure

默认报告结构：

```md
# 研究对象名称
> 研究时间：YYYY-MM-DD | 所属领域：... | 研究对象类型：...

## 1. 一句话定义
## 2. 研究摘要
## 3. 纵向分析：从起源到当下
## 4. 横向分析：当前竞争与替代格局
## 5. 横纵交汇洞察
## 6. 未来剧本
## 7. 已确认事实 / 推断 / 未知
## 8. 信息来源
## 9. 方法说明
```

## 2. Section Requirements

### 2.1 一句话定义

用一句话说清它是什么，不要写成 slogan。

### 2.2 研究摘要

交代：

- 为什么值得研究
- 当前最重要的判断
- 这份报告最核心的发现

### 2.3 纵向分析

写成阶段叙事，而不是年月堆叠。

优先展开：

- 起源
- 关键节点
- 决策逻辑
- 路径依赖
- 阶段性矛盾

### 2.4 横向分析

至少说明：

- 现在和谁放在一起看
- 核心差异在哪里
- 用户真实为什么选它
- 哪个风险最实在

### 2.5 横纵交汇洞察

这部分必须产生新判断，不能只是摘要。

### 2.6 未来剧本

至少给三个：

- 最可能
- 最危险
- 最乐观

每个剧本都要写触发条件。

## 3. Writing Style

要有研究感，也要能读下去。

推荐：

- 用具体细节代替抽象套话
- 允许叙事，但不要失去结构
- 允许判断，但要标明依据
- 允许节奏变化，但不要炫技

避免：

- “首先、其次、最后”
- “综上所述”
- “值得注意的是”
- “在当今快速发展的时代”
- “赋能、闭环、抓手”

## 4. Evidence Rules

默认做这三层标注：

- `事实`
- `推断`
- `未知`

关键事实尽量附：

- 来源名称
- URL
- 访问日期或发生日期

搜不到就写“暂缺”，不要编。

## 5. Optional PDF Delivery

如需正式交付件：

1. 先写 Markdown 母稿
2. 用 `scripts/md_to_pdf.py` 导出 PDF
3. 如环境缺依赖，退回 Markdown 交付，并把缺失依赖写明

## 6. Quality Bar

交付前自检：

- 纵轴是不是一条故事线
- 横轴是不是讲清了真实差异
- 交汇段是不是有新的判断
- 关键判断有没有证据
- 不确定的地方有没有诚实收窄
- 读者能不能快速抓住“它是什么、怎么来的、现在站哪、接下来可能怎样”