Instant Report

SKILL.md

---
name: instant-report
description: 一键生成专业产业研究报告。当用户请求行业研究、市场分析、竞品调研、公司研究报告时触发。适用场景包括但不限于："写一份XXX行业研究报告"、"生成市场分析报告"、"调研一下XXX公司"、"做个行业对比分析"、"./instant-report XXX"等任何需要输出专业报告格式的研究任务。接收中文或英文请求，自动匹配语言输出。
---

# Instant Report — 即时产业报告生成技能

## 1. 核心工作流

本技能遵循 4 阶段子代理工作流，**全流程必须依次执行，不得跳过任何阶段**：

```
用户请求
  ↓
[阶段 1] researcher  → 研究子代理：搜集资料、整理事实
  ↓
[阶段 2] report_writer → 报告子代理：撰写完整报告 + 生成图表
  ↓
[阶段 3] fact_checker  → 事实核查子代理：验证数据准确性
  ↓
[阶段 4] main agent    → 生成 DOCX + PDF 最终交付文件
```

---

## 2. 阶段详解

### 阶段 1：委托 researcher 子代理

**主 agent 绝对禁止自行搜索**，必须通过 `sessions_spawn` 委托 researcher。

```python
sessions_spawn(
  task="""[语言要求] 使用中文撰写所有研究内容。

你是一位产业研究专家。你的任务是根据用户请求，深度研究目标行业/公司，产出结构化研究简报。

研究对象：{query}
研究类型：{research_type}  # 公司研究 / 行业研究 / 对比分析

请执行以下研究步骤：
1. 多源信息搜集：搜索权威来源（行业报告、政府数据、上市公司年报、行业协会、知名咨询机构）
2. 核心事实提取：市场规模、增长率、竞争格局、主要玩家市占率、关键趋势、技术路线、政策环境
3. 数据交叉验证：同一数据点至少 2 个独立来源确认，标注每个数据点的来源和可信度（高/中/低）
4. 输出格式：用 Markdown 格式输出结构化研究简报，包含【研究摘要】【关键数据】【主要发现】【信息来源清单】

信息来源必须包括 FULL URL，纯文本报告不接受无链接数据。
禁止引用 Wikipedia，仅使用一手权威来源。
""",
  runtime="subagent",
  mode="run",
  cleanup="delete"
)
```

**输出**：结构化研究简报（Markdown 格式），包含数据点和来源链接。

---

### 阶段 2：委托 report_writer 子代理

使用 `sessions_spawn` 委托 report_writer，传递 researcher 的完整输出。

```python
sessions_spawn(
  task="""[语言要求] 使用中文撰写报告正文，图表标题和注释使用中文。

你是资深行业研究报告撰写专家。请根据以下研究素材，撰写完整的产业研究报告。

研究素材：
{research_output}

报告类型：{research_type}  # 公司研究 / 行业研究 / 对比分析
报告标题：{report_title}

## 撰写要求

1. **结构**：严格按照以下结构组织内容（可根据报告类型调整）：
   - 封面（报告标题 + 摘要 + 关键结论，150字以内）
   - 目录
   - 第一章：行业/公司概述（定义、分类、发展历程）
   - 第二章：市场分析（规模、增长率、细分市场）
   - 第三章：竞争格局（主要玩家、市占率、竞争优势）
   - 第四章：关键趋势与驱动因素
   - 第五章：挑战与风险
   - 第六章：未来展望与预测
   - 数据附录（如有）
   - 信息来源（每个数据点必须标注来源 URL）

2. **数据可视化**：为每个主要数据点生成图表建议（bar chart、line chart、pie chart 等），用 Mermaid 语法嵌入 Markdown。图表颜色使用企业蓝（#1F4E79）为主色，浅蓝（#5B9BD5）为辅助色。

3. **语言规范**：
   - 使用中文撰写
   - 客观第三人称
   - 数据驱动叙事
   - 区分事实与分析/预测

4. **质量标准**：
   - 所有统计数据必须注明来源
   - 关键结论需要 2+ 独立来源验证
   - 明确区分已核实事实与分析师观点
   - 报告正文 3000-8000 字

输出完整 Markdown 格式报告。
""",
  runtime="subagent",
  mode="run",
  cleanup="delete"
)
```

**输出**：完整 Markdown 格式产业研究报告（含 Mermaid 图表语法）。

---

### 阶段 3：委托 fact_checker 子代理

使用 `sessions_spawn` 委托 fact_checker，传递 report_writer 的完整报告。

```python
sessions_spawn(
  task="""[语言要求] 使用中文撰写核查结论。

你是专业事实核查员。请对以下产业研究报告进行严格的事实核查。

被核查报告：
{report_output}

## 核查标准

对报告中**每一个带数据的主张**逐条核查：

1. **数据真实性**：数据是否与来源一致？计算是否正确？
2. **来源可靠性**：来源是否为权威机构（一手来源 > 二手来源）？
3. **时效性**：数据是否在有效期内（一般 12 个月以内，历史分析除外）？
4. **一致性**：同一数据在不同章节是否相互矛盾？

## 输出格式

```markdown
# 事实核查报告

## ✅ 已验证（数据准确，来源可靠）
- [条目1]
- [条目2]

## ⚠️ 存疑（来源有限或数据略有出入）
- [条目1] — 存疑原因：xxx

## ❌ 错误（需要修正）
- [条目1] — 原文：xxx → 更正为：xxx（来源：xxx）

## 📝 整体评价
[总结报告可信度：高/中/低，列出主要风险点]
```

如果发现错误，在核查报告末尾附上**修正后的报告全文**（标记修改处）。
""",
  runtime="subagent",
  mode="run",
  cleanup="delete"
)
```

**输出**：事实核查报告 + （如有需要）修正后报告全文。

---

### 阶段 4：主 agent 生成最终文件

整合 researcher + report_writer + fact_checker 的输出，生成 DOCX + PDF：

**DOCX 生成**：调用 `minimax-docx` skill 生成专业格式报告。

**PDF 转换**：使用 `minimax-pdf` skill 将 DOCX 转为 PDF。

**文件命名**：`{report_title}_{YYYYMMDD}.docx` / `{report_title}_{YYYYMMDD}.pdf`

### 强制输出规范：数据版本标注

**每份报告封面后必须包含以下标注块（原文引用，不得省略）：**

```markdown
> **数据版本说明**
> - 进口数据（海关总署）：截止至 YYYY年MM月底
> - 国内生产数据（国家统计局）：截止至 YYYY年MM月
> - 价格数据（农业农村部/批发市场）：截止至 YYYY年MM月第X周
> - 政策文件：引用原文URL及发布日期
> - 市场规模预测：基于截至 YYYY年MM月 的已知信息
```

> ⚠️ 这一标注块是报告规范的核心组成部分，遗漏则报告视为不完整。

### 报告结构扩展：供需缺口量化分析

**对于行业研究报告，必须在"未来展望"章节中增加以下量化分析：**

```markdown
## 供需缺口与价格预测

### X.1 供应缺口测算
- 国内产能缺口（万吨）= 消费量 - 国产产量 - 配额内进口量
- 缺口时间节点预测：YYYY年下/半年 / YYYY年 / YYYY年
- 计算依据：[来源URL]

### X.2 价格预测情景
| 情景 | 2026年均价（元/公斤） | 主要假设 |
|------|---------------------|---------|
| 保守情景 | X | 配额上半年用完，政策严格执行 |
| 基准情景 | X | 配额按计划使用，下半年缺口显现 |
| 乐观情景 | X | 国内产能恢复超预期，进口补充充足 |

### X.3 关键风险情景
- **上行风险**：国内疫情/疫病 → 供应骤降，价格大涨
- **下行风险**：消费低迷/替代品价格低 → 需求不旺，涨价不及预期
```

---

## 3. 报告类型与结构差异

| 报告类型 | 侧重点 |
|---------|--------|
| 公司研究 | 公司概况、股权结构、财务表现、竞争定位、管理战略 |
| 行业研究 | 市场规模、产业链结构、竞争格局、关键趋势、未来预测 |
| 对比分析 | 比较框架、横向对比、优劣势分析、市场定位图、结论建议 |

---

## 4. 质量标准

- 所有统计数据必须注明来源（含完整 URL）
- 关键结论需 2+ 独立来源验证
- 明确区分事实与分析/预测
- 数据须在 12 个月有效期内（历史分析除外）
- **禁止引用 Wikipedia**，仅使用一手权威来源
- 上市公司优先引用官方年报/季报/投资者简报

---

## 5. 输出交付物

每次报告必须同时交付：
1. **Markdown 报告**（`.md`）— 工作格式
2. **Word 文档**（`.docx`）— 专业排版
3. **PDF 文件**（`.pdf`）— 最终交付
4. **信息来源清单** — 含可靠性评级

## 6. 资源文件

### references/
- `report_structure.md` — 各类型报告的详细结构模板
- `style_guide.md` — 格式规范（颜色、字体、图表样式）
- `quality_checklist.md` — 质量核查清单

### scripts/
（本技能主要依赖子代理工作流，无需额外脚本）