指数直通车场外指数基金信息查询

SKILL.md

---
name: open-fund-query
version: 1.0.0
description: |
  场外指数基金（OEF）信息查询。场外基金通常通过基金公司、银行、券商理财平台或第三方基金销售平台申购赎回，按基金净值成交，以6位基金代码识别（如110020、006748）。

  支持查询场外指数基金和ETF联接基金的基础信息、规模费率、风险等级、基金经理、持仓明细、历史分红、区间收益、跟踪误差，以及按关键词筛选和批量比较。

  适用于用户没有股票账户、通过基金销售平台持有指数基金、关注定投、A/C份额差异、联接基金与底层ETF关系等场景。如果用户关注证券交易所上市交易的ETF，应使用 etf-fund-query。
---

# 场外指数基金信息查询

把中文自然语言中的场外指数基金查询请求，转成真实数据查询，并以普通投资者能理解的方式返回事实信息和比较结果。

## 免责声明

本技能仅提供基金和指数相关数据查询服务；基于查询结果生成的归纳、比较和说明由 AI 自动生成，仅供参考，不构成投资建议、收益预测或任何交易决策依据。

## 产品说明

指数直通车 AI Skills 是易方达基金专为 AI 智能体打造的指数产品数据查询工具。它致力于搭建大模型与指数基金市场之间的信息桥梁，助力各类智能体实时调取准确、齐全的场内 ETF 与场外指数基金产品数据，全面覆盖指数基金检索、持仓分析、分红追踪等核心应用场景，显著提升指数投资的数据获取与分析效率。

因有关要求，本 skill 不提供实时行情类信息。相关信息可以通过访问指数直通车小程序和网站获取。

每位用户每日享有 500 次免费 API 接口调用额度。单次提问可能调用多个接口，额度按实际接口调用次数计算。

额度耗尽后，可在微信搜索“指数直通车”小程序，在「AI Skills」页面点击申请增加额度；每次可增加 500 次 API 查询额度，每日限增加一次。

问题反馈或技术支持邮箱：indexhub@efunds.com.cn

## When To Use

用户表达以下意图时，使用本 skill：

| 场景 | 典型请求 |
|---|---|
| 场外基金基础信息 | 查询某只基金的名称、规模、费率、风险等级、成立时间、基金经理 |
| 联接基金关系 | 查询ETF联接基金跟踪哪个指数、关联哪只ETF |
| 场外基金筛选 | 按指数、主题、规模、费率、份额类别寻找场外基金 |
| 多基金比较 | 比较多只基金的规模、费率、收益、跟踪误差、分红 |
| 定投与购买说明 | 说明场外基金购买渠道、申购确认、A/C份额差异 |
| 持仓查询 | 查询场外基金前十大持仓，区分普通指数基金、增强基金和ETF联接基金 |
| 收益与分红 | 查询区间收益、今年以来收益、成立以来收益、历史分红 |

## What This Skill Is Not

- 不提供买卖建议、收益承诺或替代投资顾问服务
- 不执行开户、申购、赎回、转换、定投设置或任何账户操作
- 不基于未经查询的数据作答；数据不可用、无权限或无匹配结果时，应明确说明限制
- 不覆盖场内ETF盘中交易场景；此类问题应转向 `etf-fund-query`

## Execution Workflow

处理用户问题时，按以下步骤执行：

1. **识别查询对象**
   - 识别6位基金代码、基金名称、跟踪指数、行业主题、份额类别或时间区间。
   - 用户只给名称或主题时，先搜索候选基金，再基于返回结果继续查询详情。

2. **选择查询能力**
   - 根据问题意图选择搜索、详情、持仓、收益或分红查询。
   - 具体接口、字段路径、单位换算和日期口径以 `references/catalog-oef.md` 为准。

3. **调用真实数据**
   - 使用本 skill 提供的本地配置和调用工具访问数据服务。
   - 不凭记忆补数据；不使用外部网页替代 skill 数据。

4. **组织回答**
   - 先给一句话结论或比较框架，再列关键数据。
   - 多产品比较时说明筛选或排序依据。
   - 只展示与用户问题相关的核心指标，默认控制在3-5项。

5. **输出前检查**
   - 最终回答必须通过本 skill 的回答检查工具处理。
   - 不展示原始响应、内部字段路径、鉴权信息、异常占位值或调试日志。

## 安装说明

- 若你单独获取并安装本 skill，请查看同目录下的 `INSTALL.md`，按其中步骤完成安装与授权配置。
- 若你使用的是 Index Hub 组合包，请优先使用组合包根目录下的 `install/install.sh` 进行统一安装。

## Runtime And Access

- 数据查询通过本 skill 随附的本地配置完成。使用前应确保已按安装说明完成授权配置。
- 运行时优先读取环境变量中的授权信息；如未配置，应按安装流程引导用户完成配置和验证。
- 回答用户时只展示查询结论和必要口径，不展示配置文件内容、鉴权信息、服务地址、原始请求或原始响应。
- 如果授权不可用、服务不可达或返回无权限，应明确说明当前无法查询，并提示用户检查配置或权限。

## Answer Validation

- 每次对用户输出最终答案前，都应使用 `guardrails.py` 中的最终回答检查能力。
- 若检查未通过，应改写答案后重新检查；不要把未通过的内容直接展示给用户。
- 该检查用于统一免责声明、清理不适合面向用户展示的内部值，并降低不当投资表达风险。

## Capability Map

| 用户意图 | 查询方式 | 回答重点 |
|---|---|---|
| 场外基金筛选 | 先搜索候选，再查详情 | 跟踪指数、规模、总费率、份额类别、成立时间 |
| 定投或新手选择 | 搜索与详情查询，可补充收益 | 用客观维度说明比较框架，不替代个人投资建议 |
| 单只基金查询 | 详情查询，可补充收益、分红或持仓 | 名称、代码、指数、规模、费率、风险等级、基金经理 |
| A/C份额比较 | 批量详情查询 | 费率结构、销售服务费、持有期限相关的成本差异 |
| 联接基金关系 | 详情查询 | 关联ETF、跟踪指数、联接基金与ETF的交易方式差异 |
| 持仓查询 | 持仓查询，必要时先查详情 | 前十大持仓、持仓比例、产品类型和报告期 |
| 区间收益 | 收益查询 | 起止日期、收益率、历史收益不代表未来表现 |
| 历史分红 | 分红查询 | 分红日期、到账日期、每份分红、分红次数 |
| 购买流程说明 | 基础说明，可结合基金候选 | 常见销售渠道、申购确认、净值成交规则 |

## Query Capabilities

| 能力 | 用途 |
|---|---|
| 关键词搜索场外基金 | 按代码、名称、指数、主题召回场外基金候选 |
| 批量场外基金详情 | 查询规模、费率、风险等级、基金经理、关联ETF等 |
| 批量场外基金持仓 | 查询前十大持仓和报告期 |
| 批量区间收益 | 查询预设周期或自定义区间收益 |
| 批量历史分红 | 查询历史分红、到账日期和分红金额 |

具体请求参数、响应路径、字段名、单位和异常值处理规则，必须以 `references/catalog-oef.md` 为准。

## Query Rules

- 同一问题包含多个意图时，按“搜索/识别标的 → 详情 → 持仓/收益/分红 → 解释与风险提示”的顺序处理。
- 主题或指数查询应做必要的关键词扩展，例如沪深300可关联300，创业板可关联创业板指，中证500可关联500。
- 比较A/C份额时，应统一费用口径，并说明不同份额类别的费用结构可能随销售平台规则变化。
- 查询持仓前应区分普通指数基金、指数增强基金和ETF联接基金；联接基金的持仓结构可能与普通股票型持仓展示不同。
- 涉及热度、涨幅、近期表现或配置思路时，应明确历史数据不代表未来收益。
- `trackError1Y` 已废弃，不作为对外字段使用；如需跟踪误差，统一使用 `annTrackError1Y`。
- 遇到无数据、代码类型不匹配或历史区间不足时，说明限制并给出可继续查询的方向。

## Accuracy Rules

- 不凭记忆填写基金名称、规模、费率、持仓、分红、收益或关联ETF；必须来自真实查询结果。
- 代码、字段、单位、日期、分页、批量上限和异常值处理，以 `references/catalog-oef.md` 为唯一口径。
- 搜索、详情、持仓、收益和分红能力的返回结构可能不同，使用前必须核对 catalog。
- catalog 中的路径一律按 JSON 路径理解，`$` 表示根节点；不要把路径文字误当成真实字段名。
- 如果按 catalog 路径取值失败，或出现字段缺失、`None`、结构与示例不一致、列表异常为空等情况，必须先请求该接口并检查真实返回 JSON 结构，再决定使用哪一层路径；禁止跨接口套用 `data`、`data.list`、`data.data` 模板猜测。
- 金额、规模、收益率、持仓比例、分红日期和到账日期必须按 catalog 口径换算和展示。
- 当返回结果为空、状态异常、历史区间不足或字段缺失时，用自然语言说明限制，不补造数据。
- 分批查询时保持每个产品与结果一一对应；多只基金比较时统一日期和指标口径。

## Compliance And Boundaries

- 只提供信息查询、事实比较和风险提示，不提供个性化投资建议、收益承诺或交易指令。
- 用户询问选择、配置、定投或是否购买等问题时，转化为客观维度比较和信息说明。
- 涉及短期热度、涨幅、近期表现或市场主题时，提醒其不代表未来收益。
- 分红信息只作为历史事实展示；分红不代表额外收益。
- 若用户问题超出本 skill 能力范围，应说明限制，并在可行时引导到场外基金或ETF的可查信息。

## Output Style

面向普通投资者，回答应简洁、稳健、可核对：

1. **一句话结论或比较框架**
2. **关键数据表格或列表**
3. **数据口径与日期**
4. **必要风险提示**

每次回答必须注明查询数据的截止日期或报告期。

最终回答末尾必须保留以下声明：

> 数据查询由易方达指数直通车提供，以上内容由 AI 总结生成，仅供参考，不构成投资建议、收益预测或任何交易决策依据。更多信息请在微信搜索“指数直通车”小程序，或访问易方达指数直通车网页版：www.etf.com.cn

## Files

| 路径 | 用途 |
|---|---|
| `references/catalog-oef.md` | 场外基金查询能力、字段口径、单位换算和示例 |
| `config.py` | 本地数据服务配置 |
| `guardrails.py` | 最终回答检查与标准声明处理 |