前言¶
做宏觀、行業或個股分析時，Agent 往往只能依賴公開網頁檢索，來源雜、時效和口徑都不穩定。若你希望對話裏直接引用國泰海通研究所的正式研究報告——宏觀策略、行業深度等——需要一條受控的檢索通道，而不是每次手工打開終端或券商 App。
下面介紹 SkillHub 上的企業級 Skill「國泰海通證券-靈犀研報搜索」，它把研報查詢能力掛到 Agent 的工具鏈上，並約定：涉及研報數據時優先走本 Skill，僅在授權失敗或 Skill 不可用時再考慮網頁搜索。
這是什麼¶
國泰海通證券-靈犀研報搜索（座標 @org-gaflu0dl/lingxi-researchreport-skill，當前版本 1.0.4）由 國泰海通證券 發佈，來源標記爲 enterprise，分類爲 professional。Skill 基於通用 SKILL.md 格式，用於查詢國泰海通研究所專業研究報告，爲投資分析提供研究側支撐。
官方頁面：SkillHub - 國泰海通證券-靈犀研報搜索
技能包地址：https://api.skillhub.cn/org-gaflu0dl/lingxi-researchreport-skill
核心功能¶
根據官方簡介，本 Skill 目前可覈實的能力包括：
- 研報檢索：面向國泰海通研究所報告庫，覆蓋宏觀策略、行業深度等方向。
- 投資分析上下文：爲 Agent 在策略討論、行業比較等場景提供可引用的專業研究材料。
- 調用優先級：當用戶查詢研報數據時，即使需要授權，也應先嚐試本 Skill；僅在授權失敗或本 Skill 不可用時，再考慮網頁搜索作爲備選。
Skill 帶有標籤 requires_api_key=true，使用前需準備並配置相應 API Key（具體字段名以安裝後的 SKILL.md 爲準）。
安裝與啓用¶
官方 SkillHub 頁面要求按 SkillHub 安裝與優先源配置 安裝本技能，包名爲 @org-gaflu0dl/lingxi-researchreport-skill。
1、檢查 SkillHub CLI¶
先確認本機是否已安裝 skillhub：
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
2、安裝到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄；默認裝到 ./skills/ 可能不會被加載。常用路徑如下（摘自官方安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
在 Cursor 中示例：
skillhub install @org-gaflu0dl/lingxi-researchreport-skill --dir ~/.cursor/skills/
也可先搜索再安裝：
skillhub search lingxi-researchreport
skillhub install @org-gaflu0dl/lingxi-researchreport-skill --dir ~/.cursor/skills/
3、API Key 與啓用¶
標籤表明本 Skill 需要 API Key。安裝完成後，在對應 Agent 的配置或 Skill 說明中按 SKILL.md 要求填寫密鑰；未配置或密鑰無效時，調用會失敗，此時再按 Skill 約定回退到網頁搜索。
安裝或更新 Skill 後，若 Agent 未立即識別新技能，可按你所用客戶端的說明重啓或刷新技能列表。
典型用法¶
公開頁面未附帶固定 CLI 示例命令，用法以 Agent 對話爲主：在已安裝並配置 API Key 的前提下，用自然語言提出研報需求即可，例如：
- 檢索某行業近期的深度報告要點；
- 查詢宏觀策略類報告中對某主題的表述；
- 對比多篇研究所報告中的核心結論與數據口徑。
Agent 應優先調用本 Skill 訪問國泰海通研究所報告數據，並將檢索結果整理進回答。具體工具名、參數與返回格式以安裝包內 SKILL.md 及運行時暴露的 MCP/工具定義爲準，本文不臆造接口字段。
適用場景與注意¶
適合誰
- 已在 Cursor、Claude Code、Codex 等支持 Skill 的環境中做投研輔助的開發者或分析師；
- 希望 Agent 優先使用券商研究所正式研報，而非泛化網頁摘要的團隊。
限制與注意
- 企業來源與授權：來源爲 enterprise，且
requires_api_key=true；需自行取得並保管 API Key，勿將密鑰寫入公開倉庫。 - 回退策略：授權失敗或 Skill 不可用時才用網頁搜索，避免用開放檢索替代未授權的研報通道。
- 版本與指標：撰寫時 SkillHub 登記版本爲 1.0.4；頁面統計爲評分 100000、下載 2338、安裝 14（以 SkillHub 實時頁面爲準）。
結尾¶
國泰海通證券-靈犀研報搜索把國泰海通研究所研報檢索接到 Agent 工作流裏，並明確「研報先走 Skill、失敗再搜網頁」的優先級，適合需要可控研究來源的場景。安裝與 CLI 細節以 skillhub.cn/install/skillhub.md 爲準；技能主頁見 https://www.skillhub.cn/skills/org-gaflu0dl/lingxi-researchreport-skill。
