指数直通车ETF信息查询

SKILL.md

---
name: etf-fund-query
version: 1.0.0
description: |
  ETF（交易型开放式指数基金）信息查询。ETF 在证券交易所上市交易，通常通过券商股票账户买卖，盘中按交易价格成交，以6位证券代码识别（如510300）。

  本 skill 不提供实时行情类信息。

  支持查询ETF基础信息、规模费率、持仓明细、历史分红、区间收益、资金流向、涨幅榜、热搜榜，以及按持仓股票反查相关ETF。

  适用于用户关注场内ETF基础信息、成交活跃度、主题ETF筛选、同类ETF比较等场景。如果用户通过银行、基金公司或第三方基金销售平台申购赎回指数基金，应使用 open-fund-query。
---

# ETF信息查询

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

## 免责声明

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

## 产品说明

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

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

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

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

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

## When To Use

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

| 场景 | 典型请求 |
|---|---|
| ETF基础信息 | 查询某只ETF的名称、规模、费率、跟踪指数、基金经理 |
| ETF筛选 | 按指数、行业主题、规模、费率、流动性寻找ETF |
| ETF比较 | 比较多只ETF的规模、费率、收益、跟踪误差、资金流向 |
| 持仓查询 | 查询ETF前十大持仓，或按股票反查持有该股票的ETF |
| 收益与分红 | 查询区间收益、今年以来收益、成立以来收益、历史分红 |
| 热点发现 | 查询涨幅榜、热搜榜、短期市场关注点 |
| 交易辅助信息 | 查询成交活跃度、场内购买相关基础信息 |

## What This Skill Is Not

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

## Execution Workflow

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

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

2. **选择查询能力**
   - 根据问题意图选择搜索、详情、持仓、收益、分红、榜单或持仓股票反查。
   - 具体接口、字段路径、单位换算和日期口径以 `references/catalog-etf.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

| 用户意图 | 查询方式 | 回答重点 |
|---|---|---|
| 主题或行业ETF筛选 | 先搜索主题候选，再查详情 | 跟踪指数、规模、费率、成交活跃度、风险提示 |
| 单只ETF查询 | 详情查询，可补充搜索、收益、持仓或分红 | 名称、代码、跟踪指数、规模、费用、基金经理；不回答单只ETF实时交易状态 |
| 多只ETF对比 | 批量详情查询，可补充收益 | 统一口径比较，说明每个结论基于哪个维度 |
| 持仓透视 | 持仓查询 | 前十大持仓、持仓比例、报告期 |
| 按股票找ETF | 持仓股票反查 | ETF名称、代码、对应股票持仓比例、规模 |
| 区间收益 | 收益查询 | 起止日期、收益率、历史收益不代表未来表现 |
| 历史分红 | 分红查询 | 分红日期、每份分红、分红次数 |
| 热榜与涨幅榜 | 发现类查询 | 热搜榜为当日指数直通车小程序内搜索累计；涨幅榜为实时涨幅榜，可返回榜单中的ETF及其跟踪指数信息 |
| 场内购买说明 | 基础说明，可结合候选ETF | 股票账户、盘中交易、交易成本和产品费用的区别 |

## Query Capabilities

| 能力 | 用途 |
|---|---|
| 关键词搜索ETF | 按代码、名称、指数、主题召回ETF候选 |
| 批量ETF详情 | 查询规模、费率、跟踪指数、基金经理、年化跟踪误差、资金流向等 |
| 批量ETF持仓 | 查询前十大持仓和报告期 |
| 批量区间收益 | 查询预设周期或自定义区间收益 |
| 批量历史分红 | 查询历史分红记录 |
| ETF实时涨幅榜 | 查询涨幅榜中的ETF及其跟踪指数信息 |
| 热搜榜 | 查询指数直通车产品内部搜索热榜中的ETF相关关键词 |
| 持仓股票反查ETF | 根据股票查找持有该股票的ETF |

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

## Query Rules

- 同一问题包含多个意图时，按“搜索/识别标的 → 详情 → 持仓/收益/分红 → 解释与风险提示”的顺序处理。
- 主题查询应做必要的关键词扩展，例如半导体可关联芯片、集成电路、科创芯片；新能源可关联新能源车、电池、光伏。
- 多只产品比较必须使用同一口径，避免把不同指数、不同主题或不同时间窗的数据直接混作结论。
- 查询热榜信息时，应说明热榜含义：该数据提供指数直通车产品内部的搜索热榜。
- 查询涨幅榜信息时，应说明其为实时涨幅榜；查询热搜榜信息时，应说明其为当日指数直通车小程序内搜索累计热榜。
- 涉及热度、涨幅、资金流向或短期表现时，应明确这类信息不代表未来收益。
- 本 skill 不提供实时行情类信息。用户询问盘中价格、盘中涨跌、溢折价状态、盘中成交或盘中换手等问题时，应说明当前能力范围，并引导其查询可用的历史收益、规模、费率、持仓、资金流向、近1月平均换手率或热搜关键词。
- 遇到无数据、代码类型不匹配或历史区间不足时，说明限制并给出可继续查询的方向。

## Accuracy Rules

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

## Compliance And Boundaries

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

## Output Style

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

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

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

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

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

## Files

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