前言¶
用掘金（gm.api）做策略開發時，文檔分散在行情、交易、股票基本面、可轉債、基金、期貨等多條產品線裏。寫回測、訂實時行情或查 stk_get_fundamentals 時，若在 IDE 裏反覆翻官方文檔覈對參數名和調用順序，會拖慢迭代。通用大模型對掘金專有接口的記憶也不穩定，容易把 history_n、subscribe、order_target_volume 等 API 混用或漏掉前置步驟（例如 set_token）。
下面介紹 SkillHub 上的 掘金量化skill（@user_7b314952/gmquant）。它在對話裏圍繞掘金 Python SDK 作答，並在你提到掘金相關關鍵詞時自動加載，把問答範圍收斂到 SDK 能力本身。
這是什麼¶
掘金量化skill 是社區來源（community）、分類爲 professional 的 Agent Skill，當前版本 1.0.1，發佈者爲 user_7b314952。Skill 頁面將其定位爲「掘金量化 Python SDK 專家技能」：當用戶討論掘金終端、策略開發、回測，或具體 API 名稱時，Agent 會加載該 Skill，按 SDK 語義組織回答。
Skill 帶有標籤 requires_api_key=true，表示涉及實盤或雲端數據時，通常需要你在掘金側配置 Token（如 SDK 中的 set_token），Skill 本身不替代賬號與終端環境。
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_7b314952/gmquant
- API 座標地址：https://api.skillhub.cn/user_7b314952/gmquant
核心功能¶
以下能力均來自 Skill 官方簡介中的觸發與覆蓋範圍，按主題歸納，便於對照你是否需要安裝。
策略運行與行情交易¶
- 量化策略開發、回測，以及
schedule定時任務。 - 實時與歷史行情：
subscribe、訂閱行情、history、history_n、current、last_tick、current_price、get_open_call_auction。 - L2 行情相關：逐筆成交、逐筆委託。
- 標的與交易日：
get_symbols、get_symbol_infos、get_history_symbol、get_trading_dates。 - 下單與賬戶：
order_volume、order_percent、order_value、order_target_volume、algo_order，以及get_orders、get_position、get_cash。
股票基本面與板塊¶
- 財務與報表：資產負債表、利潤表、現金流量表，以及
stk_get_fundamentals、stk_get_finance_audit、stk_get_finance_forecast。 - 估值與行情衍生：
stk_get_daily_valuation（PE/PB/PS、股息率、市值、股本、流通股等表述在簡介中均有提及）。 - 指數與成分：
stk_get_index_constituents、成分股相關能力。 - 行業與板塊：
stk_get_industry_category、stk_get_industry_constituents、stk_get_symbol_industry、stk_get_sector_category、stk_get_sector_constituents、stk_get_symbol_sector。 - 公司行爲與股東：
stk_get_dividend、stk_get_ration、stk_get_adj_factor、stk_get_shareholder_num、stk_get_top_shareholder、stk_get_share_change。 - 異動與資金：
stk_abnor_change_stocks、stk_abnor_change_detail、stk_get_money_flow。 - 滬深港通：
stk_quota_shszhk_infos、stk_active_stock_top10_shszhk_info。
可轉債¶
- 簡介中的
bond_convertible及分析向接口：bnd_get_analysis、bnd_get_conversion_price、bnd_get_call_info、bnd_get_put_info、bnd_get_amount_change，並覆蓋轉股溢價率、純債價值等分析場景表述。
基金與 ETF¶
fnd_get_portfolio、fnd_get_etf_constituents、fnd_get_net_value、fnd_get_adj_factor、fnd_get_dividend、fnd_get_split、fnd_get_share，對應 ETF 成分股、基金淨值等需求。
期貨¶
fut_get_contract_info、fut_get_continuous_contracts、fut_get_transaction_rankings、fut_get_warehouse_receipt，對應合約信息、連續合約、成交持倉排名、倉單數據等。
安裝與啓用¶
SkillHub 頁面給出的安裝方式是：讓 AI 按 SkillHub 安裝說明 安裝座標 @user_7b314952/gmquant。下面是與該說明一致的 CLI 路徑，安裝時需把技能裝進當前 Agent 實際使用的 skills 目錄，否則 Agent 可能識別不到。
1、確認 SkillHub CLI¶
先檢查本機是否已有 skillhub：
command -v skillhub && skillhub --version
若未安裝，可按 SkillHub 文檔執行完整安裝（含 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、安裝掘金量化skill¶
--dir 必須指向當前環境的 skills 目錄。文檔中常見路徑示例：
| 環境 | skills 目錄（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
在對應目錄下執行安裝（將 <skills 目錄> 換成你的實際路徑）：
skillhub install @user_7b314952/gmquant --dir <skills 目錄>
也可在對話中直接發送 SkillHub 頁面提供的提示詞大意：請根據 https://skillhub.cn/install/skillhub.md 安裝 @user_7b314952/gmquant。
3、啓用方式¶
Skill 設計爲關鍵詞自動加載：對話中出現掘金、gm、gm.api、上文列出的 API 名稱或場景用語時，Agent 應加載本 Skill。無需每次手動 @ 技能名，但需保證技能已安裝到當前 Client 的 skills 目錄並在必要時重啓或刷新 Agent。
典型用法¶
官方頁面未附帶完整策略源碼示例，典型用法分兩步：先完成安裝，再在自然語言問題裏點明你要用的 SDK 概念或函數名。
通過 AI 安裝（與 SkillHub 頁面一致）
在支持 Skill 的 Client 中發送：
請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_7b314952/gmquant。
在開發對話中觸發 Skill
安裝完成後，用具體問題約束範圍，例如：
- 「掘金裏
set_token之後如何用subscribe訂滬深 A 股 tick？」 - 「回測裏
history_n和history取 K 線時字段有什麼區別？」 - 「想用
stk_get_daily_valuation拉 PE/PB，日期參數怎麼傳？」
Agent 加載本 Skill 後，回答應圍繞掘金 Python SDK 的調用順序、參數與數據含義展開；你本地仍需安裝掘金 SDK、配置終端或仿真環境，並按 requires_api_key=true 在掘金側準備 Token。
適用場景與注意¶
適合誰
- 已在用或準備用掘金 Python SDK 做策略、回測、行情訂閱與下單的開發者。
- 需要在 Cursor、Claude Code、Codex 等環境裏寫策略代碼，並希望減少「記錯 API 名、漏掉前置步驟」的情況。
使用注意
- 數據來源與權限：標籤
requires_api_key=true表示真實行情與交易依賴掘金賬號與 Token；Skill 只輔助理解與生成代碼思路，不代替合規與風控判斷。 - 版本：SkillHub 展示版本爲 1.0.1；若掘金官方 SDK 升級，應以掘金當前文檔爲準，必要時在對話中說明 SDK 版本。
- 社區 Skill：來源爲
community，由 user_7b314952 發佈；生產環境建議對關鍵下單與資金邏輯自行復核官方文檔與測試結果。 - 統計信息：截至資料抓取時，SkillHub 頁面顯示評分 100000、下載 5599（頁面統計會更新，以 SkillHub 實時數據爲準）。
結尾¶
掘金量化skill 把「掘金 Python SDK 專家」封裝成可自動觸發的 Agent Skill，覆蓋從行情、交易到股票、可轉債、基金、期貨等接口族。若你經常在 AI 裏寫掘金策略，可先按 SkillHub 說明安裝 @user_7b314952/gmquant，再在問題裏直接寫出 gm.api 或具體函數名。
官方入口：
