前言¶
做量化或投研相關的 Agent 開發時，常見問題是「名字對不上號」：用戶說公司簡稱，你要查證券代碼；要寫 XS 表達式，要先確認 vfunc 名、域庫和 call_spec；生態裏還有一串 wm-* 技能，不確定該用哪一個。若全靠手工翻文檔或逐個試技能，上下文很容易被無關說明佔滿。
下面介紹 SkillHub 上的 統一發現（@user_d83d7c97/wm-discover，當前版本 1.4.3）。它把公司/代碼、行業指數、指標定義、XS 函數與域庫、選股字段、以及 SkillHub 技能檢索收斂到同一套「自然語言發現」入口，並在簡介中給出了與 wm.sh run、wm-report-extract 等技能的銜接方式。
這是什麼¶
統一發現 是社區來源（community）、分類爲 knowledge-management 的 Skill，由發佈者 user_d83d7c97（SkillHub 頁面作者顯示爲 Eliaszhou）維護。
一句話定位：用自然語言查找公司/證券代碼、行業與指數、SkillHub 技能、指標定義、XS 函數（vfunc，含 example_call_xs / call_spec 與域庫如 kline、notice、filings 等；穩定域庫隨 init 預載）、測試示例與選股字段。
標籤 requires_api_key=false，表示按 SkillHub 頁面說明，不依賴額外 API Key 配置。
官方入口：
- API 頁：
https://api.skillhub.cn/user_d83d7c97/wm-discover - SkillHub 頁：
https://www.skillhub.cn/skills/user_d83d7c97/wm-discover
核心功能¶
以下能力均來自官方簡介與 SkillHub 頁面描述，可按需組合使用。
證券與行業檢索¶
用自然語言解析 公司/證券代碼、行業與指數 等實體，減少在多個數據源或表格之間手工對照。
指標與選股字段¶
查詢 指標定義 與 選股字段，便於在寫策略、回測或對話式分析前先對齊字段含義與可用範圍。
XS 函數（vfunc）與域庫¶
針對 XS 函數，提供 vfunc 層面的發現能力，並關聯：
example_call_xs、call_spec等調用說明；- 域庫：kline、notice、filings 等（簡介中「穩定域庫已隨 init 預載」）；
- 測試示例，便於在落地表達式前核對用法。
SkillHub 技能發現¶
當不確定該用哪個 wm- 技能時，官方建議 workflow 爲：先 discover（domain=skill），再通過 wm.sh run* 執行具體技能。這樣把「找技能」和「跑技能」拆開，避免在未選型時直接硬跑錯誤技能。
與年報提取的銜接¶
簡介說明：需要從 年報 PDF 取 原文、頁碼與 quote 時，應走 wm-report-extract，與統一發現的檢索職責分工明確。
安裝與啓用¶
安裝方式以 SkillHub 官方安裝文檔爲準：https://skillhub.cn/install/skillhub.md。SkillHub 頁面給出的安裝提示爲：按該文檔安裝座標 @user_d83d7c97/wm-discover。
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/ 可能不會被識別。
skillhub install @user_d83d7c97/wm-discover --dir <你的 skills 目錄>
常用客戶端 skills 路徑（摘自官方安裝文檔，按你當前環境選用其一）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝後按你所用客戶端的慣例重啓或刷新 Agent，使 Skill 被加載。
Cursor、Codex CLI、Claude Code 的差異主要體現在 skills 目錄路徑 上；安裝命令本身均爲 skillhub install … --dir …，未發現針對本 Skill 的額外平臺專用配置項。
典型用法¶
官方簡介未給出完整可複製的一行 CLI 樣例，但給出了可復現的工作順序與參數語義，可按下面步驟在 Agent 對話中啓用本 Skill 後操作。
1、實體與指標類問題¶
在對話中用自然語言描述目標，例如：某公司對應的證券代碼、所屬行業或相關指數、某指標的定義、選股可用字段名。由 Agent 按 統一發現 的 SKILL 指引完成檢索與對齊。
2、XS 函數與域庫¶
需要寫或改 XS 表達式時，先通過發現能力定位 vfunc，並查看 example_call_xs、call_spec 以及域庫（如 kline、notice、filings）是否匹配場景；穩定域庫在 init 階段已預載，可減少重複初始化說明。
3、不確定 wm-* 技能時¶
- 使用 discover，並指定 domain=skill，在 SkillHub / wm 生態中縮小候選技能範圍。
- 選定技能後，用 wm.sh run 執行具體能力。
4、年報原文與引用¶
若目標是年報 PDF 的原文片段、頁碼與 quote，按簡介轉 wm-report-extract，而不是在統一發現裏強行完成抽取。
適用場景與注意¶
適合誰
- 在 Agent 裏做 A 股/證券相關開發或分析，需要頻繁查代碼、行業、指標與 XS 函數說明的開發者。
- 使用多條 wm-* 技能，希望先統一「發現」再「執行」的團隊。
- 希望把 SkillHub 上技能檢索與本地量化知識（指標、域庫、vfunc）放在同一對話流程裏的用戶。
限制與注意
- 本 Skill 側重 發現與對齊；仿真回測、XS 深度文檔、年報抽取等應分別使用對應 wm 技能（簡介已點名 wm.sh run、wm-report-extract）。
- 安裝路徑錯誤是常見坑：務必
skillhub install … --dir <正確目錄>。 - SkillHub 統計（截至頁面與抓取資料）：評分 100000，下載 1614；與第三方摘要數字不一致時，以 SkillHub / API 頁爲準。
- 版本以當前發佈 1.4.3 爲準，升級可用
skillhub在相同--dir下更新（遵循skillhub.md第三節）。
結尾¶
統一發現 把證券實體、指標與 XS 域庫、選股字段以及 SkillHub 上的 wm 技能檢索放到同一自然語言入口，並明確了與 wm.sh run、wm-report-extract 的分工。若你正在搭 wm 生態的 Agent，可先安裝 @user_d83d7c97/wm-discover，再按 domain=skill 的發現流程選型其他技能。
- SkillHub：
https://www.skillhub.cn/skills/user_d83d7c97/wm-discover - 安裝說明：
https://skillhub.cn/install/skillhub.md
