tushare-sync-dev

name	tushare-sync-dev
description	查询 Tushare 接口文档。**任何**涉及 Tushare 的场景都必须先调用本 skill 查文档，包括：（1）写代码/同步/对接 Tushare；（2）回答"Tushare 是否支持 X""有没有 Y 接口""某接口要多少积分""字段单位是什么""能否取美股/港股/期货/基金数据"等事实型问答；（3）排查 Tushare 返回空/报错；（4）评估 Tushare 与其它数据源的能力边界。触发词包括但不限于：Tushare、tushare、ts_code、pro_api、A股/美股/港股/期货/基金/财务/指数/资金流/龙虎榜/复权 + Tushare。**禁止凭记忆、训练数据、历史代码或邻近接口推断回答任何 Tushare 相关问题——包括"接口是否存在""积分门槛""字段单位""更新频率"。**

Tushare 文档查询

核心原则

接口名称、参数名称、字段名称、金额单位、积分门槛、覆盖范围必须以官方文档为准，禁止凭猜测、变量名、历史代码或邻近接口类推。

本规则同时适用于"写代码前"和"回答用户提问前"两个场景。 即使用户只是问"Tushare 有没有 X 接口""能不能取 Y 数据""某接口要多少积分"这类事实型问题，也必须先用本 skill 的脚本查文档再回答。凭记忆作答属于违规，因为 Tushare 接口名/积分/字段会随平台调整变化，而模型训练快照可能已过时。

判断标准：如果你即将输出的句子里出现具体的 Tushare 接口名、字段名、参数名、积分数字、单次返回上限、单位（万元/亿元/股）——这些信息必须有"刚刚查过的文档"作为依据，不能来自记忆。

使用方式

通过 skill 目录下的 Python 脚本查询文档（不使用 WebFetch）：

# 查询某个接口的完整文档
python <skill-dir>/fetch_tushare_doc.py <接口名>

# 按关键词搜索接口
python <skill-dir>/fetch_tushare_doc.py --search <关键词>

# 列出所有接口
python <skill-dir>/fetch_tushare_doc.py --list

查询流程

第一步：定位接口

• 用户明确给出接口名 → 直接查询
• 不确定接口名 → 用 --search 按关键词搜索，或读取 <skill-dir>/references/数据接口.md 浏览分类

第二步：阅读文档（必须完成）

运行脚本获取文档后，确认以下信息：

要确认的项	说明
接口名	与文档标题/示例完全一致
入参	required / optional，字段名一字不差
输出字段	实际返回的列名、数据类型
金额单位	万元 / 亿元 / 元，不同接口可能不同
所需积分	确认当前 7000 积分是否满足
单次返回上限	是否需要分页/循环
更新时间	每日几点后可取当日数据

如果文档无法访问，必须告知用户并暂停，不得继续编码。

第三步：输出摘要

将文档中的关键信息整理为结构化摘要返回给用户，包括入参表、输出字段表、注意事项。