前言¶
做產品或投研時，競品材料往往散落在官網、應用商店、新聞和 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。
