前言¶
用掘金（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 或具体函数名。
官方入口：
