前言¶
做行業分析時，常見做法是先在對話裏堆段落，再手工粘進 Word，引用來源往往對不齊、章節結構也靠臨場發揮。若目標是交付一份可對外流轉的 DOCX——帶引用標註、章節固定、還能區分「報告版」和「問卷版」——就需要一條從調研、彙編到排版的完整鏈路，而不是單次生成幾段文字。
下面介紹 SkillHub 社區技能「行業洞察報告生成器」（座標 @user_6b69962f/silvermoon-industry-insight-report，當前版本 1.1.4），它把多角度並行調研、數據彙編與引用、結構化裝配和格式適配串成一條主流程，輸出專業 DOCX。
這是什麼¶
行業洞察報告生成器是 SkillHub 上分類爲 professional 的社區技能（來源 community，發佈者 user_6b69962f），標籤標明 requires_api_key=false，安裝本技能本身不強制配置 API Key。
一句話定位：在 Agent 側按 SKILL.md 工作流，生成行業分析 / 研究報告類 DOCX；文檔生成主路徑走 minimax-docx（基於 C# OpenXML SDK 的 .NET 獨立控制台項目），環境不滿足時回退 python-docx。它解決的是「調研 → 彙編（含引用）→ 結構化成文 → 版式區分」一體化，而不是通用長文或演示稿。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_6b69962f/silvermoon-industry-insight-report
- API 資源地址：https://api.skillhub.cn/user_6b69962f/silvermoon-industry-insight-report
核心功能¶
以下能力均來自官方簡介，未單獨列出的細節不在本文展開。
完整 DOCX 鏈路¶
技能覆蓋從多角度並行調研、數據彙編與引用標註、結構化文檔裝配到格式適配的流程。最終產物是 DOCX，而非純對話摘要。
雙路徑文檔引擎¶
- 主路徑：minimax-docx（C# OpenXML SDK，.NET 獨立控制台項目），用於結構化、版式要求較高的報告輸出。
- 回退路徑：python-docx，在主路徑不可用或不適配當前環境時使用。
具體切換條件以技能包內 SKILL.md 爲準；使用前應在本地具備 .NET 運行時（主路徑）或 Python 與 python-docx（回退路徑）之一。
報告版與問卷版¶
輸出支持報告版與問卷版兩種格式適配。行業白皮書、市場調研報告走報告版；「調研問卷」「調查文件」「survey」類需求走問卷版。同一技能內通過流程分支區分，避免與通用寫作技能混用。
Agent 觸發語義¶
官方明確下列表述應優先加載本技能（節選）：
- 行業分析、行業洞察、行業研究報告、市場調研、白皮書、white paper
- 調研問卷、調查文件、survey
- 需要帶引用標註、結構化 DOCX 的完整鏈路
- 口語化請求同樣適用，例如「幫我寫個行業報告」「出份行業洞察」「調研一下 XX 行業」
不適用場景（應改用其他技能）：
- 純 PPT / HTML 展示 →
html-presentation/pptx-generator - 非行業分析的通用文檔 →
minimax-docx或其他寫作類技能
安裝與啓用¶
技能基於通用 SKILL.md 格式。在 Cursor、Claude Code、Codex 等客戶端中，需把包裝進 Agent 可識別的 skills 目錄，否則安裝後不會被加載。
1、安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可執行官方推薦的一鍵安裝（完整包含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅需要 CLI 時：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
更完整的優先源策略與沙箱聯網說明見：https://skillhub.cn/install/skillhub.md。
2、安裝本技能到當前 Agent 的 skills 目錄¶
官方頁面要求按上述安裝文檔，安裝座標：
@user_6b69962f/silvermoon-industry-insight-report
命令形式（--dir 必須指向當前 Agent 的 skills 目錄，勿省略）：
skillhub install user_6b69962f/silvermoon-industry-insight-report --dir <skills 目錄>
常用客戶端 skills 路徑示例（以 SkillHub 文檔爲準）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝到錯誤目錄（例如默認 ./skills/ 且 Agent 未配置該路徑）時，技能不會被識別；部分環境還需重啓客戶端後生效。
3、在對話中啓用¶
無需額外 API Key 配置項（requires_api_key=false）。在支持 Skills 的 Agent 裏，用上文「觸發語義」中的自然語言描述需求即可；Agent 應加載本技能並按 SKILL.md 執行調研與成文步驟。
典型用法¶
官方未提供獨立 CLI 示例子命令，典型用法是自然語言驅動 + 技能內工作流。可按下面順序與 Agent 對齊需求（示例表述可替換行業與地域，流程不變）：
-
明確對象與體裁
例如：「請用行業洞察報告生成器，做一份新能源汽車充電樁行業的市場調研報告，輸出 DOCX 報告版。」 -
補充結構與引用要求
例如：「章節需包含市場規模、競爭格局、政策與趨勢；數據處加引用標註，文末統一參考文獻。」 -
問卷類需求
例如：「針對 B2B SaaS 客戶滿意度，生成調查文件（survey），用問卷版 DOCX。」 -
跟進修訂
在首輪 DOCX 生成後，可要求增刪章節或切換報告版 / 問卷版；具體修改步驟遵循技能包內說明。
經過上面的步驟，Agent 應在並行調研與彙編完成後，調用 minimax-docx 或 python-docx 路徑寫出文件；你只需在本地打開生成的 DOCX 做終稿校對。
適用場景與注意¶
適合誰
- 需要反覆產出行業分析、白皮書、市場調研類 DOCX 的產品、戰略、諮詢或研發同學。
- 已在 Cursor / Claude Code / Codex 等環境使用 Skills，希望把「調研 + 引用 + 排版」固化成一條可重複流程的團隊。
使用注意
- 環境：主路徑依賴 .NET 與 minimax-docx 控制台項目；若僅 python-docx 可用，版式能力以回退實現爲準。
- 邊界：演示稿（PPT/HTML）和與非行業主題的一般文檔，應換用官方指明的其他技能，避免版式與流程錯配。
- 事實與引用：技能強調引用標註與結構化輸出，但數據仍來自調研步驟所能觸及的來源；對外發布前需人工覈對數字與出處。
- 版本：本文寫作時覈對到的 SkillHub 元數據爲版本 1.1.4；升級可用
skillhub對同一座標更新，並以 SkillHub 頁面爲準。
SkillHub 公開數據（撰寫時頁面展示）：評分 100000，下載約 2081 次；具體數字以 https://www.skillhub.cn/skills/user_6b69962f/silvermoon-industry-insight-report 實時爲準。
結尾¶
行業洞察報告生成器把「多角度調研、引用匯編、結構化 DOCX、報告/問卷版式」收進一條 Agent Skill 流程，主用 minimax-docx、回退 python-docx，適合從口語化行業需求直接落到可交付文檔。安裝與目錄配置請嚴格使用 --dir 指向當前客戶端的 skills 路徑。
官方地址：https://www.skillhub.cn/skills/user_6b69962f/silvermoon-industry-insight-report
安裝說明：https://skillhub.cn/install/skillhub.md
