# Industry Research Report

> 依托东方财富数据库，为指定行业生成深度研究报告。 当用户问题中出现可识别的行业/产业/领域主体，且意图属于行业认知、产业剖析或撰写研究报告时，应触发本 Skill。 常见表述如「XX 行业研究」「XX 行业报告」「帮我分析 XX 行业」「XX 产业深度研究」「XX 领域市场分析」等。 即使用户未明说「报告」，只要以某一行业为核心、要求系统性或深度的研究/分析，同样适用。

- Skill: `zhuxining/industry-research-report` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add zhuxining/industry-research-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zhuxining/industry-research-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: zhuxining (https://skillmd.com/u/zhuxining)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zhuxining/industry-research-report

---


# 行业研究报告生成 Skill

## 概述

本 Skill 用于根据用户的自由输入，使用模型提取行业关键词，调用行业研究脚本生成研究报告，最终输出包含最终返回标题、正文、PDF/DOC附件地址。

## 环境变量

| 变量名 | 说明 | 默认 |
|---|---|---|
| `INDUSTRY_RESEARCH_REPORT_OUTPUT_DIR` | 报告文件输出目录（可选） | `./miaoxiang/industry_research_report` |


## 执行流程

### Step 1：提取行业关键词 `{{topic}}`

用户的输入形式较为自由，可能是一句话、一个短语或一段描述，但一定包含"行业主体"这一关键信息。

**你需要做的：**
- 从用户问句中精准提取行业关键词，记为 `{{topic}}`。
- 提取时只保留核心行业主体名称，去除多余的修饰词（如"帮我看看"、"分析一下"等）。
- 如果用户问句中包含多个行业，优先提取最核心的那个（也可以在必要时合并，如"新能源汽车"）。

**示例：**

| 用户输入 | 提取的 `{{topic}}` |
|---|---|
| "帮我生成一份半导体行业的研究报告" | 半导体 |
| "我想了解一下新能源汽车产业的发展趋势" | 新能源汽车 |
| "AI芯片行业深度分析" | AI芯片 |
| "请分析消费电子与智能家居两个领域的交叉趋势" | 消费电子与智能家居 |

### Step 2：调用行业研究报告写作脚本

以 `{{topic}}` 为入参，调用`scripts/get_data.py` 行业研究脚本：

```bash
python3 {baseDir}/scripts/get_data.py --query "{{topic}}"
```

脚本功能：生成相应的行业研究报告并将其分别用pdf和docx的格式保存。

脚本返回字段说明：

```
{
    "title": "生成的报告标题",
    "truncated_text": "研究报告的部分正文内容",
    "pdf_output_path": "完整报告的pdf文件保存地址",
    "docx_output_path": "完整报告的docx文件保存地址",
    "share_url": "完整报告的分享链接"
}
```

注意：**禁止调用 任何「后台执行、稍后汇报」的方式跑本脚本**，只能在当前会话中同步等待到命令完成，拿到 stdout 的结果后再继续。否则 Step 3 无法执行，从而导致本 Skill 失败。

### Step 3：最终输出结果

Step 2 成功后，将返回的 title、truncated_text、pdf_output_dir、docx_output_dir 等结果填入下方模板，生成最终回复。

```
《[title]》

已经生成行业研究报告。此处仅展示部分正文内容，请下载附件查看报告详情和参考信息。（不要删减这段话）

[truncated_text]...

**附件：**
- 📄 [title].pdf 已保存到 [pdf_output_path]
- 📄 [title].docx 已保存到 [docx_output_path]

**分享链接：**
[share_url]
```

注意：若Step 2中的脚本返回的[truncated_text]部分为空，则读取接口返回的docx附件内容，总结相关报告信息返回，以确保最终输出的[truncated_text]内容非空。

## 错误处理

| 错误码 | 含义 | 用户侧话术 |
|---|---|---|
| `ERROR_TOPIC_TOO_LONG` | topic 超出 500 字限制 | "字数超出限制，请尝试其它主体。" |
| 其他异常 | 接口调用失败等 | "报告生成服务暂时不可用，请稍后重试。" |

## 安全与隐私提示（必读）
- **文件落盘**：脚本会写入本地文件。请通过环境变量 `INDUSTRY_RESEARCH_REPORT_OUTPUT_DIR` 指定保存位置，确保目录可写且符合你的合规要求。
- **外链谨慎**：服务端可能返回分享链接，请仅在你信任的网络环境中打开，并留意域名与跳转。