deep-search-m

name	deep-search-m
version	1.0.1
description	专业深度研究与报告生成技能。支持企业竞争分析、产品竞争分析、行业分析、市场规模/竞争格局、AI大模型厂商、AI工具学习指南等领域。基于 Agent 内置 `web_search` + `web_fetch`（无需 API key），三阶段工作流（主题确认→框架生成→报告输出），运用PESTEL、SWOT、波特五力、商业模式画布等经典咨询研究模型，输出精美的深蓝色政务风格 HTML 与 Markdown 双格式咨询级报告。 English: A professional deep-research and report-generation skill for company/product/industry/market/AI-vendor topics. Uses the Agent built-in `web_search` + `web_fetch` (no API key) with a three-stage workflow (topic confirmation → framework generation → report output), applying consulting models like PESTEL, SWOT, Porter's Five Forces, and Business Model Canvas to produce polished Markdown + deep-blue HTML consulting reports.

专业研究报告技能

概述

该技能用于生成专业、咨询级别的研究报告，覆盖市场分析、AI 大模型厂商、SaaS 厂商、AI 工具学习指南、竞争情报、行业研究等领域。

核心能力

• ✅ 多源检索能力：使用 Agent 内置 web_search + web_fetch（无需 API key）
• ✅ 三阶段工作流：主题理解与确认 + 分析框架生成 + 报告生成
• ✅ 交互式确认：支持用户确认、修改、提问等交互式反馈
• ✅ 双格式输出：Markdown + HTML，深蓝色政务风格

何时使用本技能

• 用户请求市场分析、消费者洞察报告、财务分析、行业研究
• 用户输入具体 AI 工具名称，需要生成学习指南（如"Cursor 学习指南"）
• 用户需要专业的咨询风格研究报告
• 用户提供研究主题，并在数据收集前需要结构化分析框架

整合的技能与能力

本技能整合了以下核心搜索能力，提供多源数据搜索与分析支持：

整合来源	路径	能力说明	版权归属
web_search	内置	Agent 内置快速搜索能力，用于获取基础信息	Agent 内置
web_fetch	内置	Agent 内置深度抓取/检索能力，用于获取更详细页面内容	Agent 内置

能力集成说明：

本技能使用 Agent 内置 web_search 与 web_fetch 完成数据采集与检索（无需 API key）

---

三阶段工作流

阶段 0：主题理解与确认

目的：确保正确理解用户的研究需求，避免方向偏差。

工作流程：

1. 解析用户输入

   • 识别研究主题、分析领域、搜索范围、特定角度

2. 推断分析领域

根据主题关键词推断分析领域，加载对应的领域文档：

主题类型	关键词示例	领域文档
行业分析	"{行业名}行业分析"、"ERP行业趋势"、"AI Agent行业"	references/domains/industry-analysis.md
企业竞争分析	"{公司名}分析"、"{公司名}竞争分析"、"{公司名}研究"、金蝶、用友、SAP等	references/domains/company-analysis.md
产品竞争分析	"{产品名}分析"、"{产品名}研究"、"{产品名}竞争力"	references/domains/product-analysis.md
市场规模/竞争格局	"市场规模分析"、"竞争格局研究"、"市场机会评估"	references/domains/market-analysis.md
AI 大模型厂商	OpenAI、Anthropic、DeepSeek、智谱AI等	references/domains/ai-vendor-analysis.md
AI 工具学习指南	"AI工具使用指南"、"Gemini教程"	references/domains/ai-tool-learning-guide-framework.md

推断逻辑：

1. 行业关键词（行业分析、行业趋势、行业研究）→ 行业分析

2. 企业名称 + 分析/研究 → 企业竞争分析

3. 产品名称 + 分析/研究 → 产品竞争分析

4. 市场规模/竞争格局关键词（市场规模、竞争格局、市场机会）→ 市场规模/竞争格局分析

5. AI 厂商名（OpenAI、DeepSeek等）→ AI 厂商分析

6. 生成确认提示

向用户展示以下确认项，等待用户确认或修改：

确认项	说明	示例
研究主题	解析后的核心研究对象	"金蝶企业竞争分析"
研究方向	分析领域及分析角度	"企业竞争分析：商业模式 + 竞争格局 + 近期动态"
时间范围	数据收集的时间窗口	"近一周" / "近一月" / "自定义（如2024Q1）"

时间范围说明：

• 近一周：聚焦最新动态、热点事件、近期发布
• 近一月：平衡时效性与深度，适合大多数分析
• 自定义：特定时间段（如财报季、产品发布周期）

时间参数传递：

• 时间范围确认后，记录为全局参数 search_time_range
• 在阶段1数据收集时，自动转换为搜索时间过滤条件
• 示例：search_time_range = "近一周" → 搜索引擎添加 &before=2026-03-18&after=2026-03-11

4. 处理反馈
   • 用户确认 → 记录时间参数，进入阶段 1
   • 用户修改 → 更新确认项后重新确认
   • 用户提问 → 解答后重新确认

详细流程和示例：见 references/workflow/phase0-details.md

---

阶段 1：分析框架生成

目的：生成完整的分析框架，作为后续数据收集与报告生成的蓝图。

工作流程：

1. 理解研究主题

   • 识别核心对象和分析领域
   • 加载对应的领域文档（references/domains/*.md）

2. 选择分析模型

   • 根据领域文档推荐，按需加载模型文件（references/models/*.md）
   • 每次研究只加载 2-4 个模型，避免堆砌
   • 模型索引：references/models/README.md

3. 设计章节骨架

   • 每章包含：分析目标、分析逻辑、核心假设
   • 典型结构：3-5 个主要章节

4. 定义数据需求

   • 每条需求包含：指标、类型、来源、搜索方法、优先级
   • P0 数据必须收集，P1 重要，P2 补充

5. 定义可视化方案

   • 为每章定义图表类型和数据来源

详细流程和示例：见 references/workflow/phase1-details.md

---

阶段 2：报告生成

目的：将分析框架和数据整合为最终的咨询级报告。

工作流程：

1. 接收并校验输入

   • 确认分析框架和数据包齐全
   • 检查 P0 数据完整性

2. 映射报告结构

   • Abstract → Introduction → Body Chapters → Conclusion → References

3. 撰写报告

   • 遵循"视觉锚点 → 数据对比 → 综合分析"流程
   • 每个小节以充分的分析段落结尾（≥200字）

4. 撰写摘要和结论

   • 摘要：3-5 句话，200-300 字
   • 结论：纯客观综合判断，不使用 bullet points

5. 整理参考文献

   • 按 GB/T 7714-2015 格式列出

6. 生成输出文件

   • Markdown 文件：assets/report-template.md
   • HTML 文件：根据分析模型组合模块化模板

HTML 模板系统：

位于 assets/templates/ 目录，提供 10 个模块化模板：

模板文件	分析模型
product-overview-template.html	产品概览
target-users-template.html	目标用户分析
core-features-template.html	核心功能
business-model-canvas-template.html	商业模式画布
porter-five-forces-template.html	波特五力分析
swot-analysis-template.html	SWOT 分析
pestel-analysis-template.html	PESTEL 分析
competitor-matrix-template.html	竞品对比矩阵
timeline-template.html	关键时间线
key-metrics-template.html	关键指标

模板组合建议：

研究类型	推荐模板组合
AI 厂商/产品	产品概览 → PESTEL → 目标用户 → 竞品矩阵 → 商业模式画布 → SWOT → 核心功能
市场竞争	产品概览 → PESTEL → 波特五力 → 竞品矩阵 → 关键指标
商业模式	产品概览 → PESTEL → 商业模式画布 → SWOT
行业研究	产品概览 → PESTEL → 波特五力 → 关键指标 → 时间线

详细流程和示例：见 references/workflow/phase2-details.md

---

数据收集策略

两层搜索方案（web_search -> web_fetch）

第一层：Agent 内置 web_search（优先使用）

• 快速获取基础信息
• 参数：query、max_results（建议 3-10）
• 适用场景：验证“信息是否存在”、获取初始线索

第二层：web_fetch 深度搜索

• 直接访问搜索引擎获取详细结果
• 只抓取与本次研究结论直接相关的页面/段落（不进行自动遍历、批量爬取）
• 支持使用常见搜索运算符（如站点限定/文件类型限定/时间过滤），具体见 references/technical/search-engines.md
• 详细使用方法：见 references/technical/search-engines.md
• 适用场景：当需要更详细的页面内容/报告片段时

边界说明：

• 本技能不自动运行仓库内的本地采集脚本（例如 scripts/data_collector.py）。如需在本地执行任何网络采集脚本，请显式启用网络请求、设置请求上限，并遵守目标站点的 robots 与访问条款。

搜索策略执行逻辑

对于每个数据需求（P0/P1/P2）：

1. 先使用 web_search 快速获取
   - 成功：进入数据提取
   - 失败：进入第2层

2. 使用 web_fetch 深度搜索
   - 成功：进入数据提取
   - 失败：标注"数据暂不可得"

数据提取：
- 从搜索结果中提取关键数据
- 多源交叉验证（至少2个来源）
- 标注数据可信度（high/medium/low）

内置搜索能力说明

本技能已内置整合以下搜索能力，用户无需额外安装任何子技能：

搜索层	能力来源	说明
第1层	Agent 内置 web_search	默认优先使用
第2层	Agent 内置 web_fetch	深度搜索
（仅两层：web_search 与 web_fetch）。所有检索通过 Agent 内置这两个能力完成（无需 API key）。所有通用 URL 模板与使用方法见 references/technical/search-engines.md

---

数据真实性协议

严格遵循规则：报告中呈现的所有数据，必须直接来源于提供的 Data Summary 或 External Search Findings。

• 禁止幻觉：不得编造、估算或模拟数据
• 可追溯来源：每个重要结论和图表都必须能够追溯到输入的数据包
• 数据缺失处理：如数据缺失，明确写出"数据暂不可得"

---

输出格式

Markdown 文件

• 文件名：{主题关键词}-report-{日期}.md
• 模板：assets/report-template.md

HTML 文件

• 文件名：{主题关键词}-report-{日期}.html
• 模板：assets/html-template.html
• 风格：深蓝色政务/企业内报风格
• 布局：左侧树状导航（固定）+ 右侧内容展示

格式与语气标准

• 语气：麦肯锡 / BCG 风格 —— 权威、客观、专业
• 数字格式：千位分隔使用英文逗号（1,000）
• 数据强调：重要观点和关键数字需加粗
• 标题编号：使用标准编号（1.、1.1）
• 参考文献：必须严格遵循 GB/T 7714-2015

---

参考文档体系

领域分析框架

文档	说明
references/domains/industry-analysis.md	行业分析框架（PESTEL + 波特五力 + 价值链）
references/domains/company-analysis.md	企业竞争分析框架（含 SaaS 厂商分析，商业模式画布 + SWOT + 竞品矩阵）
references/domains/product-analysis.md	产品竞争分析框架（目标用户 + 竞品矩阵 + 核心功能）
references/domains/market-analysis.md	市场规模/竞争格局分析框架（TAM-SAM-SOM + 波特五力）
references/domains/ai-vendor-analysis.md	AI 大模型厂商分析框架
references/domains/ai-tool-learning-guide-framework.md	AI 工具学习指南生成框架
references/domains/hotspot-analysis.md	热点分析公共模块（企业/产品/AI/SaaS/全球AI热点）

工作流程详细文档

文档	说明
references/workflow/phase0-details.md	阶段0 详细流程和示例
references/workflow/phase1-details.md	阶段1 详细流程和示例
references/workflow/phase2-details.md	阶段2 详细流程和示例
references/workflow/examples-complete.md	完整示例集（5个场景）

技术指南

文档	说明
references/technical/search-engines.md	多源搜索引擎使用指南
references/technical/data-quality-guidelines.md	数据质量控制标准
references/technical/format-conversion.md	格式转换指南

HTML 模板

文档	说明
assets/templates/README.md	模板使用说明
assets/templates/*.html	10 个模块化 HTML 模板

分析模型库

文档	说明
references/models/README.md	模型索引和使用说明
references/models/strategic/*.md	战略模型（SWOT、PESTEL、波特五力、VRIO）
references/models/market/*.md	市场模型（STP、BCG、TAM-SAM-SOM）
references/models/competitive/*.md	竞争模型（商业模式画布、竞品矩阵、价值链）
references/models/consumer/*.md	消费者模型（决策旅程、AARRR、RFM）
references/models/financial/*.md	财务模型（杜邦分析、DCF、可比公司）

方法论

文档	说明
references/methodology/deep-research-methodology.md	深度研究方法论
references/methodology/report-writing-guide.md	报告撰写指南

---

质量检查清单

阶段 0（主题理解与确认）

• 研究主题已明确
• 分析领域已识别
• 搜索范围已确定
• 用户已确认

阶段 1（分析框架）

• 框架覆盖了该领域自然应有的全部分析维度
• 每章均有明确的分析目标、分析逻辑与核心假设
• 数据需求具体、可衡量，并指定了推荐搜索方法
• 每章至少有一个可视化方案

阶段 1→2（数据收集）

• 所有 P0 数据任务已完成
• 关键数据至少从 2 个来源验证
• 数据来源已记录
• 数据可信度已标注

阶段 2（报告生成）

• Markdown 报告零幻觉
• 每个小节均遵循"数据对比 → 综合分析"
• 参考文献格式正确（GB/T 7714-2015）

---

配置项

output_locale = zh_CN  # zh/en
default_search_engines = ["baidu", "bing", "google"]
data_validation_required = true  # P0 数据必须验证
interactive_confirmation = true  # 交互式确认，支持用户修改研究参数

---

版本历史

• v1.0.0: 正式版
  • 三阶段工作流（主题确认→框架生成→报告输出）
  • 使用 Agent 内置 web_search + web_fetch（无需 API key）
  • 支持市场分析、行业分析、AI/SaaS厂商分析、竞争情报、竞争分析等领域
  • 交互式主题确认，支持用户修改研究参数
  • 双格式输出（Markdown + HTML）
  • 两层搜索策略（web_search → web_fetch）