前言¶

给通用大模型 Agent 装上黄金投研能力，常见的做法是把金价新闻塞进去让它”分析一下”。这种做法的问题在于：数据来源不明、口径随时变化、预测无法验证，做出来的结论既不能追溯，也不能事后复盘。要做成能放进生产环境的工具，至少需要三样东西：明确的标的与周期、可降级的数据层、以及预测—复盘—校准的闭环。

下面介绍的「黄金投资分析Skill」就是按这个思路做的。它是 SkillHub 上的 community 分类 Skill，坐标 @user_9d5a2a39/gold-advisor，发布者 user_9d5a2a39，页面版本 1.0.2，简介中标注模型版本为 v1.3.0。分类为 professional，页面评分 100000，下载 2178 次，安装 0 次，标签 requires_api_key=false，即不需要 API Key。

这是什么¶

一句话定位：一个面向黄金多标的、多周期涨跌预测与投研报告生成的 Agent Skill，配套回测、复盘、知识库同步和 MCP 服务。

它解决的是：Agent 在回答”金价会涨吗”“黄金能买吗”这类问题时，没有结构化数据、没有因子拆解、没有概率与区间输出，也没有事后验证手段。Skill 把数据获取、因子分析、模型集成、报告输出、复盘存证串成一条链路，并允许 agent 以工具方式直接调用。

核心功能¶

标的与周期¶

标的覆盖伦敦金 XAU、COMEX 黄金期货 GC、沪金、上金所 Au9999、纸黄金代理、黄金 ETF（518880 等）、SPDR GLD、黄金股指数、黄金股 ETF、GDX。

周期分两类：历史回溯最长 200 年，用于长期序列分析；未来预测分 1 周、1 个月、3 个月、半年、1 年五个区间。

因子与模型¶

八类因子量化分析：美元 DXY、实际利率 TIPS、地区局势 GPR、资金流向 SPDR 持仓、央行购金、政策事件、技术面、关联资产。

预测方法是技术外推 + ARIMA + GARCH + MonteCarlo 的分周期集成，再经投研经理判断框架裁决，输出方向、概率、P10/P90 区间、目标价、失效位。也就是说，结果不是单一模型的点预测，而是带概率和区间的形式。

数据层降级链¶

数据层设计了五级降级：实时、本地价格库、磁盘缓存、陈旧、样例。同时带 data_quality 质量分级。

这一层的关键设计是：当落到样例数据时，数据会被强制标注，不会冒充实盘。这对做演示和测试很重要——Agent 不会把假数据当成真实行情继续推理。

回测与复盘¶

支持 ensemble 级多周期 walk-forward 回测，回测结果自动折减并落库。

跟进分析（followup）用于命中率统计和概率校准。配合每日例行能力，形成”预测存证 → 到期复盘 → 命中率跟踪”的闭环。

报告输出¶

可生成 Word、PDF、PPT 三种格式，每种格式对应三档深度。工程细节上做了中文字体防乱码和图表失败隔离——即单个图表生成失败不会拖垮整份报告。

知识库同步¶

分析结果与数据可双向同步 ima、dify、Obsidian、语雀、思源、flomo 等 11 类知识库，并可读回检索。双向意味着写入后还能取回，适合做长期积累和二次分析。

MCP Server¶

内置 MCP Server，路径 scripts/mcp_server.py，提供 14 个工具，走 stdio 协议。支持 Model Context Protocol 的 agent 可以直接把它当工具调用，不必经过 Skill 的文本交互层。

安装与启用¶

官方页面未在抓取资料中给出具体安装命令，以下只说明启用方式，不提供未经核实的命令。

1、Skill 基于通用 SKILL.md 格式。将 Skill 目录放入客户端的 Skill 加载路径，或在支持 Agent Skill 的客户端（Cursor、Claude Code 等）中指向该目录，由客户端读取 SKILL.md 完成注册。

2、MCP 方式启用：在支持 MCP 的 agent 配置中加入指向 scripts/mcp_server.py 的 stdio 服务，14 个工具会随服务启动暴露，agent 可直接按工具名调用。

3、不需要配置 API Key，页面标签 requires_api_key=false。

资料中未核实到 Cursor、Codex CLI、Claude Code 三者的具体配置差异，此处不做分别说明。

典型用法¶

以下命令来自官方简介中的命名，参数未在资料中给出，使用前需查阅 Skill 内的 SKILL.md。

每日例行：执行 daily 命令，完成数据获取并累积进 SQLite、到期自动复盘、生成当日新预测。适合固定时间跑一遍，形成连续跟踪。

回测：对 ensemble 级多周期 walk-forward 做回测，结果自动折减并落库，用于验证各周期的预测表现。

跟进分析：执行 followup，统计命中率并做概率校准，判断历史输出的概率是否有系统性偏差。

MCP 调用：在支持 MCP 的 agent 中直接调用 14 个工具中的具体方法，按标的和周期取预测结果，无需经过自然语言问答。

适用场景与注意¶

适合做黄金相关的投研辅助、每日跟踪、历史回测和报告生成，尤其是需要把预测结果沉淀下来做长期验证的场景。

需要注意几点。第一，页面版本 1.0.2 与简介中标注的 v1.3.0 不一致，功能边界以 Skill 目录内 SKILL.md 的实际内容为准。第二，数据层在降级到”陈旧”或”样例”时，data_quality 会相应降级，分析结果必须结合该标记使用，不能把降级数据下的输出当作实时判断。第三，输出的方向、概率、区间是模型集成与判断框架的结果，属于分析工具而非投资建议，实际决策仍需人工复核。第四，安装数为 0，说明目前使用者很少，遇到问题主要靠源码和文档自查。

结尾¶

这个 Skill 的价值在于把黄金投研中容易缺失的几件事补齐了：明确的标的和周期定义、带降级标注的数据层、可回测可复盘的闭环、以及能被 agent 直接调用的 MCP 接口。如果需要在 agent 里做长期、可验证的黄金分析，它是一个可以在此基础上继续打磨的起点。

官方地址：https://api.skillhub.cn/user_9d5a2a39/gold-advisor
SkillHub 页面：https://www.skillhub.cn/skills/user_9d5a2a39/gold-advisor