前言¶
做产品或投研时，竞品材料往往散落在官网、应用商店、新闻和 PDF 手册里。自己搭搜索、抓取、排版，步骤多且格式难统一。下面介绍 SkillHub 社区 Skill「竞品调研」（@user_183dc2cb/productresearch）：把调研维度、工具链和 Word 版式写进 SKILL.md 与模板脚本，由 Agent 按固定流程执行，最后输出可交付的 .docx 报告。
这是什么¶
「竞品调研」是面向 data-analysis 场景的 Agent Skill，版本 1.0.0，来源为 community，由发布者 user_183dc2cb 维护。SkillHub 页面坐标为 @user_183dc2cb/productresearch；标签 requires_api_key=false，不依赖额外 API Key。
输入公司或产品名称后，Skill 指导 Agent 完成：背景与历史、服务与产品、市场规模、竞品对比、App/软件功能、用户反馈、衍生品与手册、PDF 截图，并生成 Word 报告。
核心功能¶
以下能力均来自包内 SKILL.md、README.md 与 research_template.py。
固化的调研维度¶
Skill 将标准提纲写进说明文档，便于 Agent 逐项填充，主要包括：
- 公司：名称、全称、总部、上市信息、员工规模、股东结构
- 历史：成立时间、融资/并购/上市/更名等里程碑
- 服务：经纪/投行/资管/研究/科技平台等业务线（文档以金融类公司为例，Agent 可按行业替换表述）
- 市场：覆盖市场、账户数、成交量等
- 竞品：主要竞争者及份额
- App：名称、平台、版本历史、评分、安装量、日活/月活等
- 用户与反馈：画像、应用商店评分与正负面评论关键词
- 手册与截图：官方 PDF 地址、摘要、按页渲染的截图
- 衍生品：金融产品列表及规模类指标（按实际调研对象调整）
工具链分工¶
| 步骤 | 工具 | 说明 |
|---|---|---|
| 背景与官网 | web_search、web_fetch |
官网、年报、新闻 |
| 竞品与市场 | web_search |
份额、竞争格局 |
| App 数据 | web_fetch（如 App Store / Google Play） |
评分、功能、版本 |
| PDF 手册 | urllib.request（文档注明可用 SSL 绕过） |
下载官方 PDF |
| 截图 | PyMuPDF（fitz） |
2x 矩阵渲染 PNG |
| 报告 | python-docx |
按规范生成 Word |
报告版式¶
模板脚本将字体与结构固化，减少每次手工调样式：
- 正文：SimSun 12pt，
#333 - 标题一至三：SimSun 加粗，三级蓝色（
#1F4E79/#2E75B6/#3A8CC7） - 表格：9pt，表头白底蓝字，交替行淡蓝底
- 页眉：公司名与日期，右对齐；页码居中页脚
文档结构：封面 → 目录 → 公司背景 → 服务 → 市场 → App 调研 → 手册截图 → 总结 → 参考资料。截图需放在输出目录下的 screenshots/ 子目录，再嵌入 Word。
安装与启用¶
通过 SkillHub CLI（推荐）¶
先确认已安装 skillhub（安装方式见 SkillHub 安装文档）。安装本 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能无法被识别。
skillhub install productresearch --namespace user_183dc2cb --dir ~/.cursor/skills/
Cursor 常用路径为 ~/.cursor/skills/；Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。按你实际使用的客户端替换 --dir 即可。
通过自然语言让 Agent 安装¶
SkillHub 页面提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_183dc2cb/productresearch`。
WorkBuddy / CodeBuddy 变体¶
包内附带 install.sh，会检测 ~/.codebuddy/skills、~/.clawbuddy/skills 或 ~/.workbuddy/skills，将 Skill 复制到 competitive_research 子目录。在 Skill 包目录执行：
bash install.sh
安装后按对应客户端说明重启或刷新 Skill 列表。
Python 依赖¶
生成报告依赖 python-docx 与 PyMuPDF（import fitz）。在运行 research_template.py 的环境中提前安装，例如：
pip install python-docx pymupdf
典型用法¶
启用 Skill 后，用自然语言触发即可。README.md 中的约定是：用户说「调研 XXX 公司」，Agent 按 SKILL.md 执行搜索、抓取、PDF 处理与写稿，并调用模板生成 Word。
也可直接运行包内脚本（需已安装上述 Python 库）：
python3 research_template.py <公司名> <工作目录>
README.md 与脚本注释说明输出文件名为 {公司名}_竞品调研报告.docx；SKILL.md 另有一处写作 {公司名}_竞品调研.docx，以你实际脚本输出为准。SKILL.md 中还提到可由 Agent 执行 python3 调研脚本生成器.py 公司名，与包内文件名 research_template.py 对应关系以你安装包中的文件为准。
Agent 侧需具备 web_search、web_fetch 等能力，才能完成检索与页面抓取；纯离线环境只能使用模板排版，无法自动补全调研内容。
适用场景与注意¶
适合谁
- 需要重复做公司/产品竞品梳理，且希望报告版式统一的个人或小团队
- 已在 Cursor、Claude Code、Codex 或 WorkBuddy 系客户端中使用 Skill 的开发者
限制与注意
- 信息来自公开网页与应用商店，时效性与准确性需人工复核；Skill 不替代合规或投资决策流程。
- PDF 下载失败时，文档建议用
ssl._create_unverified_context()绕过 SSL，存在安全风险，仅在可信来源、受控环境中使用。 - 调研维度示例偏金融经纪类公司，其他行业需自行调整章节与检索词。
- SkillHub 统计（截至页面抓取）：评分 100000，下载 1471，安装 32；安装量会随时间变化，以 SkillHub 详情页 为准。
结尾¶
「竞品调研」把调研提纲、Agent 工具链和 Word 样式收敛到一个社区 Skill 里，适合把「搜资料 + 写报告」交给 Agent 流水线处理。安装坐标 @user_183dc2cb/productresearch，官方入口：https://www.skillhub.cn/skills/user_183dc2cb/productresearch。
