前言¶
做组合或换仓时，常需要看几只基金净值是否同涨同跌。手工在表格里拉历史、对齐日期、再算相关系数，步骤多且容易漏对齐。若把「取数 + 算矩阵 + 出报告」交给带 Skill 的 Agent，可以在对话里直接给出可复用的 CSV 或 HTML。下面介绍 SkillHub 社区 Skill「基金相关性分析」（@user_a706bb76/finance001，v1.0.1）。
这是什么¶
「基金相关性分析」是面向 data-analysis 场景的 Agent Skill，由社区发布者 user_a706bb76 维护；SkillHub 页面标注作者为 xibei。Skill 内置 Python 脚本 fund_correlation_v3.py，通过 AkShare 拉取国内基金净值，计算多只基金之间的 皮尔逊相关系数，支持 3 / 6 / 12 个月 窗口，并可输出 CSV 与 HTML 可视化报告（亦可输出控制台表格或 JSON）。标签标明 requires_api_key=false，无需单独配置 API Key。
SkillHub 收录信息（2026-10-22 抓取）：评分 100000，下载 902 次；分类为 data-analysis，来源 community。
核心功能¶
经 Skill 包内 SKILL.md 与脚本说明核对，能力包括：
- 数据源：
ak.fund_name_em()解析基金简称，ak.fund_open_fund_info_em()取历史净值（天天基金网 + AkShare）。 - 标的范围：面向国内发售基金（ETF、开放式、LOF、QDII、货币、债券等）；输入为至少 2 个六位基金代码，脚本亦支持代码与名称混合输入。
- 时间跨度：
--period可选3m、6m、12m（默认3m）。 - 输出：
--output可选table（默认）、csv、json、html；HTML 含颜色编码矩阵与两两配对说明。 - 环境：依赖本机
python；可选环境变量PYTHONIOENCODING，简介建议设为utf-8，避免中文输出乱码。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
按 SkillHub 安装文档 检查或安装：
command -v skillhub && skillhub --version
未安装时可执行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能无法加载。SkillHub 页面给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_a706bb76/finance001。
命令行示例（slug 需带 @ 前缀）：
skillhub install @user_a706bb76/finance001 --dir ~/.cursor/skills/
其他客户端常见路径（同样替换 --dir）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
安装后按所用客户端要求重启或刷新 Skill 列表。
3、Python 依赖¶
进入 Skill 目录后安装脚本依赖：
pip install akshare pandas
建议在运行前设置输出编码（与 Skill 元数据一致）：
export PYTHONIOENCODING=utf-8
典型用法¶
Skill 目录下的主程序为 fund_correlation_v3.py。下列命令来自官方 SKILL.md，可直接复现。
基础用法（至少两只基金）：
python fund_correlation_v3.py 510050 510300 159919
指定 3 个月窗口并生成 HTML 报告：
python fund_correlation_v3.py 510050 510300 --period 3m --output html
导出 CSV：
python fund_correlation_v3.py 510050 510300 --output csv
多基金 QDII 与指数增强示例（含周期与 HTML）：
python fund_correlation_v3.py 006105 000614 003629 003646 --period 3m --output html
参数摘要：
| 参数 | 说明 |
|---|---|
| 基金代码 positional | 六位数字，至少 2 个 |
--period / -p |
3m、6m、12m，默认 3m |
--output / -o |
table、csv、json、html |
--verbose / -v |
打印拉数与加载日志 |
在 Cursor 等环境中，也可在对话里说明基金代码、时间跨度和输出格式，由 Agent 按 SKILL.md 调用上述脚本。
适用场景与注意¶
适合：需要快速看组合内基金是否高度同向（例如 ETF 对比、QDII 与国内指数增强的线性相关）、或要把矩阵交给后续表格/汇报流程（CSV / HTML）。
限制与注意（Skill 文档已写明）：
- 数据依赖 AkShare 与公开市场接口，部分 QDII 可能延迟或缺失。
- 皮尔逊系数只刻画线性关系；文档建议结合多个
--period交叉看。 - 多基金收益率按「最小共同长度」对齐，成立期过短或停牌可能导致有效样本变少。
- 历史相关不代表未来表现，不构成投资建议。
Skill 元数据中 homepage 指向 https://github.com/workbuddy/fund-correlation-tool，可作为脚本背景的补充参考；以 SkillHub 安装包内 SKILL.md 与 fund_correlation_v3.py 为准。
结尾¶
「基金相关性分析」把国内基金净值拉取、皮尔逊矩阵计算和 CSV/HTML 报告串成一条可脚本化路径，适合挂在 Agent 上做组合层面的快速核对。安装与详情见 SkillHub：
- 页面：https://www.skillhub.cn/skills/user_a706bb76/finance001
- 坐标：
@user_a706bb76/finance001 - API 条目：https://api.skillhub.cn/user_a706bb76/finance001
