前言¶
做量化或投研相关的 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
