Skill: jianghaist/instant-report (version 1.0.0)

--- 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/ （本技能主要依赖子代理工作流，无需额外脚本）

path: references/data_sources.md
content: # 权威信息来源渠道清单

> 生成产业报告时，必须优先从以下渠道获取数据。按优先级分为三级。

---

## 🔴 第一优先级：中国官方数据（免费，直接引用）

### 1. 海关总署 — 进出口数据
| 渠道 | 网址 | 内容 | 更新频率 |
|------|------|------|---------|
| 海关统计月报 | http://gdfs.customs.gov.cn/（各月进口商品量值表） | 牛肉、羊肉分国别进口量（万吨） | 每月 |
| 海关统计数据在线查询 | http://stats.customs.gov.cn/ | 按商品/国别/月份多维查询 | 每月 |
| 海关总署新闻发布 | http://www.customs.gov.cn/ | 外贸进出口总体情况 | 每月中旬 |

> 商品编码：牛肉 0201–0202；羊肉 0204

### 2. 国家统计局 — 生产数据
| 渠道 | 网址 | 内容 | 更新频率 |
|------|------|------|---------|
| 国家统计局年度公报 | stats.gov.cn/sj/zxfb/ | 牛/羊存栏量、出栏量、产量 | 每年2月 |
| 农业农村部数据平台 | http://zdscxx.moa.gov.cn:8080/misportal/ | 畜产品批发价格指数 | 每日/每周 |
| 农业农村信息网 | https://www.agri.cn/sj/jcyj/ | 每周监测动态（含猪牛羊肉价格） | 每周 |

### 3. 商务部 — 贸易政策
| 渠道 | 网址 | 内容 |
|------|------|------|
| 商务部公告 | http://www.mofcom.gov.cn/zwgk/zcfb/ | 所有对外贸易政策文件原文 |
| 贸易救济调查局 | https://trb.mofcom.gov.cn/ | 保障措施、反倾销、反补贴案件 |
| 中国贸易救济信息网 | https://cacs.mofcom.gov.cn/ | 进口调查公告、配额分配 |

> ⚠️ 政策文件是行业转折点的核心判断依据，必须第一时间引用原文。

### 4. 中国畜牧业协会 — 行业调研
| 渠道 | 网址 | 内容 |
|------|------|------|
| 中国畜牧业协会 | https://www.caaa.cn/ | 行业调研报告、年度形势分析 |
| 全国畜牧总站 | https://www.nahs.org.cn/ | 国际畜产品贸易数据 |

---

## 🟡 第二优先级：国际权威机构（免费，建议引用）

### 5. USDA（美国农业部）— 全球数据
| 渠道 | 网址 | 内容 | 更新频率 |
|------|------|------|---------|
| USDA ERS（经济研究局） | https://www.ers.usda.gov/topics/animal-products/cattle-beef/ | 美国及全球牛肉供需平衡表 | 每月 |
| USDA FAS（月度报告） | https://apps.fas.usda.gov/psdonline/ | 全球畜产品贸易流向 | 每月 |
| USDA GAIN 报告 | https://apps.fas.usda.gov/newgainapi/ | 中国市场专项报告（PDF） | 按需 |

> USDA 是全球肉类市场最权威的数据源，其供需平衡表是行业研究的事实标准。

### 6. FAO / OECD-FAO — 全球展望
| 渠道 | 网址 | 内容 |
|------|------|------|
| OECD-FAO Agricultural Outlook | https://www.oecd.org/en/publications/oecd-fao-agricultural-outlook-2025-2034/ | 10年全球农产品预测（年度） |
| FAO 粮食及农业报告 | https://openknowledge.fao.org/ | 全球畜牧业展望 |

### 7. 主要出口国数据（补充验证）
| 国家 | 机构 | 网址 | 关键数据 |
|------|------|------|---------|
| 澳大利亚 | MLA（肉类畜牧协会） | https://www.mla.com.au/ | 牛羊存栏、出口量月度数据 |
| 新西兰 | Beef + Lamb NZ | https://beeflambnz.com/ | 羊群存栏、出口数据 |
| 巴西 | ABIEC（肉类出口商协会） | https://www.abiec.com.br/ | 巴西牛肉产量、出口数据 |

---

## 🟢 第三优先级：付费咨询机构（参考估算，需注明）

| 机构 | 适用场景 | 说明 |
|------|---------|------|
| Fortune Business Insights | 全球市场规模估算 | 可引用，但需注明"据咨询机构估算" |
| Grand View Research | 行业 CAGR 估算 | 同上 |
| IndexBox | 全球贸易流数据 | 适合获取全球羊肉市场数据 |
| 智研咨询 / 华经产业研究院 | 中国细分市场 | 适合补充国内数据验证 |

> ⚠️ 咨询机构数据必须与官方数据交叉验证后才可引用，禁止单一来源使用。

---

## 📌 数据溯源规范（强制执行）

每份报告必须在开头注明：

```
本报告数据来源优先级：
第一优先级（直接引用）：海关总署、国家统计局、商务部原文
第二优先级（辅助验证）：USDA、FAO、行业协会
第三优先级（参考估算）：咨询机构（需标注"据XX机构估算"）
```

### 交叉验证规则

| 数据类型 | 最少验证来源数 | 单位必须统一 |
|---------|-------------|-----------|
| 进口量（万吨） | ≥2（海关+USDA 或 海关+行业协会） | 万吨 |
| 国产产量（万吨） | ≥2（统计局+协会） | 万吨 |
| 价格（元/公斤 vs 美元/吨） | ≥1，且必须注明单位 | — |
| 政策文件 | 必须引用原文URL | — |
| 同比/环比增长率 | 必须验算复核 | — |

---

## 🔗 快速查询书签（每次研究优先访问）

```
[海关总署统计月报] http://gdfs.customs.gov.cn/
[农业农村部数据]   http://zdscxx.moa.gov.cn:8080/misportal/
[商务部公告]       http://www.mofcom.gov.cn/zwgk/zcfb/
[贸易救济调查局]   https://trb.mofcom.gov.cn/
[USDA牛肉数据]     https://www.ers.usda.gov/topics/animal-products/cattle-beef/
[农业农村信息网]   https://www.agri.cn/sj/jcyj/
[USDA GAIN中国]    https://apps.fas.usda.gov/newgainapi/ （搜索 China）
[MLA澳大利亚]      https://www.mla.com.au/
```


path: references/quality_checklist.md
content: # 质量核查清单

## 必检项（每份报告必须通过）

### ⭐ 来源核查
- [ ] **每个数据点都有来源标注**（来源名称 + URL）
- [ ] **第一优先级来源优先**（海关总署/国家统计局/商务部原文 > USDA/FAO > 咨询机构）
- [ ] 无 Wikipedia 引用
- [ ] 所有 URL 可正常访问（附原文链接为加分项）

### ⭐ 数据准确性
- [ ] **每个来源国比例数字 ≥ 2 个独立来源确认**
- [ ] 进口量 + 国产产量 与 总消费量 误差 < 5%（缺口须弥合）
- [ ] 数字计算正确（百分比、总计）
- [ ] **价格单位必须注明（美元/吨 vs 元/公斤，禁止混用）**
- [ ] 同比/环比计算正确
- [ ] 数据在时效范围内（≤12个月，历史分析除外）

### ⭐ 数据版本标注（新增强制项）
- [ ] 封面后有「数据版本说明」标注块
- [ ] 每类数据（进口/生产/价格/政策）注明截止日期
- [ ] 预测内容与历史数据明确区分

### ⭐ 内容完整性
- [ ] 有执行摘要（≤150字）
- [ ] 涵盖市场规模、增长率、竞争格局
- [ ] **有供需缺口量化分析（含具体缺口万吨数）**
- [ ] **有价格预测情景（保守/基准/乐观三档）**
- [ ] 有风险因素分析
- [ ] 信息来源完整列出

### ⭐ 逻辑一致性
- [ ] 全文数据相互印证，无矛盾
- [ ] 章节之间逻辑连贯
- [ ] 结论与证据匹配
- [ ] SWOT 分析有数据支撑

### ⭐ 语言规范
- [ ] 第三人称叙述
- [ ] 无主观情绪用语
- [ ] 专业术语使用准确
- [ ] 无错别字

### ⭐ 格式规范
- [ ] 标题层级清晰（章/节/小节）
- [ ] 图表有编号和标题
- [ ] 表格数据对齐
- [ ] 适当分段，无超长段落

## 评分标准

| 等级 | 要求 |
|------|------|
| ⭐⭐⭐ 高可信 | 全部必检项通过，关键数据 3+ 来源 |
| ⭐⭐ 中可信 | 全部必检项通过，主要数据 2+ 来源 |
| ⭐ 低可信 | 部分必检项未通过或数据来源单一 |

## 常见错误警示

1. **"据报道""数据显示"** — 未注明具体来源，扣分
2. **单一来源** — 关键结论必须有多个来源
3. **过时数据** — 使用超过 12 个月的数据需特别说明
4. **计算错误** — 百分比、总计必须验算
5. **矛盾数据** — 不同章节同一数据必须一致


path: references/report_structure.md
content: # 产业研究报告结构模板

## A. 公司研究（Company Research）

```
第一章 公司概况
  1.1 基本信息（成立时间、总部、主要业务）
  1.2 发展历程与里程碑
  1.3 股权结构（主要股东、机构持仓）

第二章 业务与产品
  2.1 业务布局（各业务线收入占比）
  2.2 核心产品/服务
  2.3 上下游产业链位置

第三章 财务表现
  3.1 营收与利润趋势（3-5年）
  3.2 盈利能力分析（毛利率、净利率）
  3.3 现金流状况
  3.4 财务预测

第四章 竞争格局
  4.1 行业定位
  4.2 SWOT 分析
  4.3 核心竞争优势
  4.4 主要竞争对手对比

第五章 战略展望
  5.1 未来战略方向
  5.2 潜在增长点
  5.3 风险因素
```

## B. 行业研究（Industry Research）

```
第一章 行业概述
  1.1 行业定义与分类
  1.2 行业发展历程
  1.3 产业链结构

第二章 市场规模与增长
  2.1 全球/区域市场规模（TAM/SAM/SOM）
  2.2 历史增长率
  2.3 细分市场分析
  2.4 市场增长驱动因素

第三章 竞争格局
  3.1 主要玩家与市占率
  3.2 市场集中度
  3.3 竞争壁垒
  3.4 波特五力分析

第四章 关键趋势与驱动因素
  4.1 技术路线演进
  4.2 政策环境
  4.3 需求端变化
  4.4 供给端变革

第五章 未来展望
  5.1 2024-2030 市场规模预测
  5.2 新兴机会
  5.3 主要风险与挑战
```

## C. 对比分析（Comparative Analysis）

```
第一章 比较框架
  1.1 比较对象
  1.2 比较维度与方法论

第二章 横向对比
  2.1 市场规模对比（表格）
  2.2 财务指标对比
  2.3 产品/服务对比
  2.4 技术实力对比

第三章 竞争定位
  3.1 差异化定位图
  3.2 各玩家优劣势分析

第四章 综合评价
  4.1 评分矩阵
  4.2 分析结论
  4.3 战略建议
```


path: references/style_guide.md
content: # 报告格式与图表规范

## 颜色系统

| 用途 | 色值 | 说明 |
|------|------|------|
| 主色 | #1F4E79 | 企业蓝，标题、图表主色 |
| 辅助色 | #5B9BD5 | 浅蓝，图表辅助、背景 |
| 强调色 | #E74C3C | 红色，关键风险标注 |
| 正面色 | #27AE60 | 绿色，增长/正面指标 |
| 中性色 | #7F8C8D | 灰色，次要文字 |
| 背景色 | #F8F9FA | 浅灰白，表格背景 |
| 文字色 | #2C3E50 | 深灰蓝，正文 |

## 字体规范

- 标题：思源黑体 / Source Han Sans CN / Noto Sans SC（fallback: Microsoft YaHei）
- 正文：思源宋体 / Source Han Serif CN / Noto Serif SC（fallback: Georgia）
- 数据：Roboto Mono / Source Code Pro（数字等宽）

## 图表规范

### Mermaid 语法嵌入 Markdown

**柱状图（市场对比）**：
````
```mermaid
bar chart
    title 市场对比（亿美元）
    "公司 A": 120
    "公司 B": 85
    "公司 C": 63
```
````

**折线图（趋势）**：
````
```mermaid
line chart
    title 全球市场规模趋势（2020-2025E）
    2020: 340
    2021: 385
    2022: 420
    2023: 475
    2024E: 530
    2025E: 610
```
````

**饼图（市场份额）**：
````
```mermaid
pie title 市场格局
    "玩家 A": 32
    "玩家 B": 24
    "玩家 C": 18
    "其他": 26
```
````

## 表格规范

使用 Markdown 标准表格，数据右对齐：
```
| 指标 | 2022 | 2023 | 同比 |
|------|-----:|-----:|-----:|
| 营收 | 120  | 140  | +17% |
```

## 章节编号

- 一级标题：第一章 / 第二章（黑体，居中）
- 二级标题：1.1 / 1.2（左对齐）
- 三级标题：（1）/（2）


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (CRITICAL)