1---
2name: tushare
3description: 面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求，转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。
4author: tushare.pro
5version: 1.1.12
6credentials:
7  - name: TUSHARE_TOKEN
8    description: Tushare Token，用于认证和授权访问Tushare数据服务。
9    how_to_get: "https://tushare.pro/register"
10requirements:
11  python: 3.7+
12  packages:
13    - name: tushare
14  environment_variables:
15    - name: TUSHARE_TOKEN
16      required: false
17      sensitive: true
18  network_access: true
19---
20 
21# tushare
22 
23把自然语言财经数据请求，转成可执行的 Tushare 数据工作流。
24 
25这是一个面向自然语言的金融数据研究 skill。
26 
27 
28## What this skill is for
29 
30使用这个 skill 的典型场景：
31 
32- 看某只股票、指数、ETF 最近走势
33- 查公司基本资料、估值、财务趋势
34- 做多标的横向对比
35- 看资金流、北向资金、龙虎榜、板块强弱
36- 梳理公告、新闻、研报、政策线索
37- 查看 CPI / PPI / PMI / 社融 / 利率等宏观数据
38- 导出 CSV / parquet 供后续分析或回测使用
39- 生成简洁研究摘要，而不是只吐原始字段表
40 
41先理解用户要解决什么问题，再去选接口、取数、整理、解释、交付。
42 
43***
44 
45## When to use
46 
47当用户表达以下意图时，优先使用本 skill：
48 
49### 行情 / 趋势
50 
51- 看下 XX 最近怎么样
52- XX 这段时间涨得怎么样
53- 今年以来表现如何
54- 最近有没有放量
55- 这票最近强不强
56 
57### 财务 / 估值 / 公司质量
58 
59- 看下 XX 财报
60- 最近几个季度利润趋势
61- 财务质量怎么样
62- 现金流好不好
63- 现在估值算高吗
64- 帮我看 PE / PB / ROE / 毛利率
65 
66### 对比 / 排行 / 筛选
67 
68- XX 和 YY 谁更强
69- 帮我横向比较一下
70- 哪些公司利润增长更快
71- 帮我筛一下高 ROE 低负债
72- 给我排个前十
73 
74### 板块 / 指数 / 主题
75 
76- 最近哪个板块最强
77- 半导体最近怎么样
78- 机器人为什么涨
79- 指数成分股有哪些
80- 哪些主题最热
81 
82### 资金流 / 情绪
83 
84- 最近资金在买什么
85- 北向资金最近流向哪里
86- 哪个板块最吸金
87- 主力资金流入最多的是谁
88- 龙虎榜上有什么看点
89 
90### 公告 / 新闻 / 研报 / 政策
91 
92- 最近有什么公告
93- 帮我梳理下 XX 公告
94- 最近有没有什么催化
95- 最近新闻面怎么样
96- 最近有什么重要政策
97 
98### 宏观 / 跨市场
99 
100- 最近宏观环境怎么样
101- CPI / PMI 最近怎么看
102- 当前市场风格偏什么
103- 大盘环境偏多还是偏空
104- 港股 / 美股 / 美债最近怎么样
105 
106### 数据导出 / 研究准备
107 
108- 给我导出一份行情数据
109- 把近两年日线拉成 CSV
110- 生成可回测的数据表
111- 拉一个研究表供后续分析
112 
113***
114 
115## What this skill is NOT for
116 
117这个 skill 不适合：
118 
119- 直接给买卖建议或替代投资顾问
120- 自动下单或执行交易
121- 需要毫秒级实时交易决策的场景
122- 复杂回测引擎、组合优化系统本身的实现（那是另一个工程）
123- 在没有 Tushare 权限/积分支持的情况下强行伪造数据
124 
125如果数据权限不够、接口不可用或时间范围不合理，要明确说出限制，不要硬编。
126 
127***
128 
129## Natural-language trigger guide
130 
131即使用户完全不说 `tushare`、`financials`、`macro` 这些术语，只要意图符合以下含义，也应该触发本 skill。
132 
133### 常见口语触发
134 
135- 看看这个股票最近怎么样
136- 给我快速研究一下 XX
137- 上次说的那只票现在什么情况
138- 帮我看下财报
139- 最近哪个板块最强
140- 北向最近在买什么
141- 有什么催化消息
142- 这个公司值不值得重点看
143- 给我拉份数据
144- 导出成 CSV
145- 帮我筛一批票
146- 把这几个公司对比一下
147 
148### 中文自然语言优先原则
149 
150用户说人话时，先理解任务，不要先回到接口名和字段名。
151优先把：
152 
153- “最近” 解释成合理时间窗
154- “财报” 解释成最近 8 个季度 / 最近年度
155- “强不强” 解释成走势 + 相对强弱 + 活跃度
156- “资金关注” 解释成净流入、活跃成交、龙虎榜/北向等可用口径
157 
158如果任务有多个合理解释，再做最小澄清。
159 
160***
161 
162## Environment check
163 
164在真正请求数据之前，先做前置校验：
165 
1661. 检查 Python 是否可用， 版本要求 3.7+
1672. 检查 `tushare` 包是否已安装·
1683. 检查 `TUSHARE_TOKEN` 是否存在.
1694. 必要时做一次轻量接口冒烟测试（如交易日历 / 基础接口）
1705. 如用户请求高权限接口，提前提示可能存在积分/权限限制
171 
172若缺失 token，直接提示最短修复路径，例如：
173 
174```bash
175export TUSHARE_TOKEN=your_token
176```
177 
178不要等到主查询跑失败了才暴露环境问题。
179 
180***
181 
182## Intent taxonomy
183 
184先识别任务类型，再决定接口组合。
185 
186### 1. 行情 / 趋势
187 
188典型问题：
189 
190- 最近走势怎么样
191- 今年涨了多少
192- 最近波动大不大
193- 最近有没有放量
194 
195常用接口：
196 
197- `daily`
198- `pro_bar`
199- `weekly`
200- `monthly`
201- `stk_mins`
202- `rt_k` / `rt_min`（如确需实时口径且权限允许）
203- `daily_basic`
204 
205### 2. 基本资料 / 标的识别
206 
207典型问题：
208 
209- 这是什么公司 / 什么指数 / 什么基金
210- 是创业板吗 / 是 ST 吗 / 什么时候上市
211 
212常用接口：
213 
214- `stock_basic`
215- `fund_basic`
216- `index_basic`
217- `stock_company`
218- `stock_st` / `st`
219 
220### 3. 财务 / 公司质量
221 
222典型问题：
223 
224- 最近几个季度利润趋势
225- 最近几个季度营收和净利润趋势
226- 财务质量怎么样
227- ROE / 毛利率 / 现金流如何
228 
229常用接口：
230 
231- `income`（营收 / 净利润趋势优先）
232- `fina_indicator`（ROE / 毛利率 / 净利率等质量指标补充）
233- `balancesheet`
234- `cashflow`
235- `forecast`
236- `express`
237- `disclosure_date`
238 
239### 4. 估值 / 基本面指标
240 
241典型问题：
242 
243- 现在估值高不高
244- 谁更便宜
245- PE / PB / 股息率如何
246 
247常用接口：
248 
249- `daily_basic`
250- `fina_indicator`
251 
252### 5. 资金流 / 市场行为
253 
254典型问题：
255 
256- 北向最近买什么
257- 主力资金流向
258- 龙虎榜情况
259 
260常用接口：
261 
262- `moneyflow`
263- `moneyflow_hsgt`
264- `hsgt_top10`
265- `top_list`
266- `top_inst`
267- `moneyflow_ind_dc`
268- `moneyflow_mkt_dc`
269 
270### 6. 板块 / 指数 / 主题
271 
272典型问题：
273 
274- 最近哪个板块最强
275- 行业轮动如何
276- 某板块有哪些成分股
277 
278常用接口：
279 
280- `index_basic`
281- `index_daily`
282- `index_classify`
283- `index_member_all`
284- `sw_daily`
285- `ths_index`
286- `ths_member`
287- `dc_index`
288- `dc_member`
289 
290### 7. 打板 / 情绪 / 活跃度
291 
292典型问题：
293 
294- 今天涨停梯队
295- 连板结构
296- 炸板率 / 情绪强弱
297 
298常用接口：
299 
300- `limit_list_d`
301- `limit_step`
302- `kpl_list`
303- `dc_hot`
304- `ths_hot`
305 
306### 8. 公告 / 新闻 / 研报 / 政策
307 
308典型问题：
309 
310- 最近有什么公告或催化
311- 最近有什么研究报告
312- 最近政策面发生了什么
313 
314常用接口：
315 
316- `anns_d`
317- `news`
318- `major_news`
319- `research_report`
320- `npr`
321- `irm_qa_sh`
322- `irm_qa_sz`
323 
324### 9. 宏观 / 跨市场
325 
326典型问题：
327 
328- CPI / PMI / 社融 / M2
329- 利率与收益率曲线
330- 港股 / 美股 / 美债数据
331 
332常用接口：
333 
334- `cn_cpi`
335- `cn_ppi`
336- `cn_pmi`
337- `cn_gdp`
338- `cn_m`
339- `sf_month`
340- `shibor`
341- `shibor_lpr`
342- `us_tycr`
343- `us_daily`
344- `hk_daily`
345- `index_global`
346 
347### 10. 导出 / 研究准备
348 
349典型问题：
350 
351- 导出某标的一段时间行情
352- 生成回测用数据表
353- 输出 CSV / parquet
354 
355常用接口：
356 
357- 取决于上游任务，核心是统一输出规则与命名规范
358 
359***
360 
361## Entity resolution rules
362 
363### 标的解析
364 
365- 优先识别股票名、股票代码、指数名、ETF 名、基金名
366- 对中文简称先尝试匹配标准对象
367- 若重名或多解，列出候选并做最小澄清
368- 证券代码内部统一为标准格式，如：`600519.SH`、`000001.SZ`
369 
370### 市场识别
371 
372- 默认先按 A 股理解，除非用户明确提到港股 / 美股 / 基金 / 债券 / 期货
373- 指数、ETF、个股要分开判断，不要混用接口
374 
375### 时间默认值
376 
377若用户没有明确给时间范围，使用合理默认：
378 
379- “最近走势” → 默认近 20 个交易日
380- “这段时间 / 最近一段时间” → 默认近 3 个月
381- “财报 / 业绩” → 默认最近 8 个季度 + 最近年度
382- “资金流最近如何” → 默认近 5～20 个交易日，按任务粒度调整
383- “宏观最近如何” → 默认看最近 6～12 期
384 
385### 板块口径默认值
386 
387若用户只说“板块 / 行业 / 概念”但未指定分类体系：
388 
389- 行业优先用申万 / 中信等较稳定口径
390- 概念优先同花顺 / 东方财富等主题口径
391- 若结论依赖具体口径差异，要明确说明使用了哪种分类
392 
393***
394 
395## Input normalization rules
396 
397在请求数据前先做规范化：
398 
399- 日期统一为 `YYYYMMDD`
400- 检查 `start_date <= end_date`
401- 用户输入未来日期时，自动裁剪到最近可用日期并提示
402- 裸代码如 `000001` 不要盲猜，能补全则说明补全规则，不能补全则澄清
403- 对冲突参数（如 `trade_date` 与 `start_date/end_date` 同时给）要先裁决，不要直接乱传
404 
405***
406 
407## Data retrieval rules
408 
409### 文档先行
410 
411在写请求代码前，先确认：
412 
413- 接口名是否正确
414- 必填参数
415- 可选参数
416- 返回字段
417- 积分 / 频率限制
418 
419不要仅凭记忆硬写字段名。
420 
421### 字段确认
422 
423对 `fields` 参数，优先使用已知字段白名单或接口文档确认。
424若用户要求字段不存在，应明确说明，而不是盲查。
425 
426### 默认分段拉取
427 
428长区间数据不要一次性全拉。
429建议：
430 
431- 日线 / 周线 / 月线：按年或季度切片
432- 财报：按年份 / 报告期切片
433- 分钟数据：按月 / 周切片
434- 大批量多标的：按标的分批 + 日期分段
435 
436### 重试与限流
437 
438- 仅对瞬时错误（网络抖动、超时、429）进行有限重试
439- 参数错误、权限不足、字段错误不要盲重试
440- 批量拉取时加入节流，避免高频撞限
441 
442### 分段合并
443 
444分段拉取后：
445 
446- 合并
447- 去重
448- 按主键排序
449- 记录失败分段
450- 若部分成功，要明确告诉用户哪些段失败了
451 
452***
453 
454## Output contract
455 
456除非用户明确只要原始表，否则优先按这个结构输出：
457 
4581. **一句话结论**
4592. **数据范围与口径**
4603. **关键指标 / 关键表格**
4614. **异常点 / 风险点 / 解释限制**
4625. **如有本地输出，给出文件路径**
463 
464### 结果交付形态
465 
466按任务复杂度选择：
467 
468- 小结果：Markdown 摘要 + 简短表格
469- 中等数据表：CSV
470- 大规模 / 后续分析：Parquet
471- 需要可复用流程：附 Python 脚本
472- 需要可视化时：输出图表 PNG 或说明可绘制图表
473 
474### 元信息
475 
476生成数据文件时，尽量同时记录：
477 
478- 接口名
479- 请求参数
480- 拉取时间
481- 数据行数
482- 字段列表
483- 是否存在失败分段 / 缺失
484 
485***
486 
487## Workflow templates
488 
489下面这些模板，是本 skill 的核心。
490不要直接从接口想起，而要从任务模板想起。
491 
492### 1. 单标的行情分析
493 
494适用：
495 
496- 看下 XX 最近怎么样
497- 这票最近强不强
498- 今年以来表现如何
499 
500默认流程：
501 
5021. 解析标的
5032. 确定时间范围
5043. 取行情 + 必要基础指标
5054. 总结区间涨跌、成交活跃度、高低点、波动
5065. 输出一句结论 + 关键数字
507 
508### 2. 多标的横向对比
509 
510适用：
511 
512- XX 和 YY 谁更强
513- 把这几家公司对比一下
514 
515默认流程：
516 
5171. 锁定对象
5182. 统一时间口径
5193. 选 3～5 个关键指标
5204. 输出对比表
5215. 给出“谁在哪方面更强”的总结
522 
523### 3. 财务质量快照
524 
525适用：
526 
527- 看下 XX 财报
528- 最近几个季度利润趋势
529- 财务质量怎么样
530 
531默认流程：
532 
5331. 拉最近 8 个季度 + 最近年度财务核心数据
5342. 区分营收、利润、毛利率、ROE、现金流
5353. 标出改善 / 恶化 / 波动点
5364. 说明累计值、单季值、同比口径
537 
538### 4. 估值分析 / 筛选
539 
540适用：
541 
542- 现在估值高不高
543- 谁更便宜
544- 筛低估值高股息
545 
546默认流程：
547 
5481. 明确标的池
5492. 拉 `daily_basic` 等估值指标
5503. 必要时联动财务质量
5514. 输出排序、极值、口径说明
552 
553### 5. 资金流追踪
554 
555适用：
556 
557- 最近资金在买什么
558- 北向最近流向哪里
559- 主力资金流入最多的是谁
560 
561默认流程：
562 
5631. 明确资金口径（北向 / 主力 / 龙虎榜 / 板块资金）
5642. 确定时间窗
5653. 拉净流入 / 活跃成交 / 持续性
5664. 和价格表现联动解释
5675. 避免把单日噪声说成趋势
568 
569### 6. 板块 / 题材轮动分析
570 
571适用：
572 
573- 最近哪个板块最强
574- 机器人最近强在哪
575- 某概念板块里有哪些成分股
576 
577默认流程：
578 
5791. 确定分类口径
5802. 拉板块区间表现
5813. 必要时联动成分股、资金流、涨停梯队
5824. 输出强势板块排行与代表标的
583 
584### 7. 公告 / 新闻 / 事件梳理
585 
586适用：
587 
588- 最近有什么公告
589- 有没有什么催化
590- 最近新闻面怎么样
591 
592默认流程：
593 
5941. 明确对象和时间窗
5952. 拉公告 / 新闻 / 研报 / 政策数据
5963. 去噪，提炼 3～5 条主线
5974. 区分事实、公告、媒体解读
5985. 必要时结合股价异动做弱因果解释
599 
600### 8. 数据导出与研究准备
601 
602适用：
603 
604- 拉一份 CSV
605- 做回测数据表
606- 导出某段时间的行情/财务数据
607 
608默认流程：
609 
6101. 明确数据范围、频率、字段
6112. 采用分段策略取数
6123. 清洗、去重、统一字段类型
6134. 输出 CSV / parquet
6145. 给出文件路径和元信息
615 
616### 9. 综合研究简报
617 
618适用：
619 
620- 给我快速研究一下 XX
621- 做个投资者视角简报
622- 先给个全景判断
623 
624默认流程：
625 
6261. 一句话结论
6272. 行情表现
6283. 财务趋势
6294. 估值水平
6305. 资金流情况
6316. 公告 / 新闻催化
6327. 风险点
6338. 值得继续深挖的问题
634 
635***
636 
637## Data quality rules
638 
639拉取完成后，至少做这些检查：
640 
641- schema 校验
642- 关键字段存在性检查
643- 主键去重
644- 固定排序
645- 日期标准化
646- 数值字段类型规范化
647 
648### 空结果处理
649 
650空表不一定是失败，要区分：
651 
652- 非交易日
653- 区间无数据
654- 股票未上市
655- 参数错误
656- 接口权限不足
657 
658不要把所有空结果都说成“接口坏了”。
659 
660***
661 
662## Cache and reuse rules
663 
664为了让 skill 可长期复用，应优先支持：
665 
666- 基础表缓存（如 `stock_basic`、交易日历、指数基础信息）
667- 增量更新，而不是每次全量重拉
668- 大任务断点续跑
669- 结果文件规范命名
670 
671推荐命名格式：
672 
673- `daily_600519.SH_20230101_20231231_20260322.csv`
674- `fina_indicator_300750.SZ_20260322.parquet`
675 
676缓存命中时，最好说明哪些来自缓存，哪些是新拉取的数据。
677 
678***
679 
680## Error handling
681 
682优先用“人话 + 调试细节分层”的方式输出错误。
683 
684### 用户可见层
685 
686- token 未配置
687- 当前接口可能需要更高积分/权限
688- 时间范围过大，已自动改为分段拉取
689- 股票名称不唯一，请确认是哪一个
690- 当前结果为空，可能因为该日期非交易日 / 标的未上市 / 无权限
691 
692### 调试层
693 
694必要时补：
695 
696- 接口名
697- 参数
698- 失败分段
699- 异常原文
700 
701### 部分成功原则
702 
703如果部分分段失败，不要说“成功完成”。
704应明确说：
705 
706- 哪些部分成功
707- 哪些部分失败
708- 是否已生成不完整结果
709 
710***
711 
712## Recommended minimal interface set
713 
714主 skill 正文不要塞几百个接口。
715优先记住 80% 常用任务的核心接口集：
716 
717- `stock_basic`
718- `trade_cal`
719- `daily`
720- `pro_bar`
721- `daily_basic`
722- `fina_indicator`
723- `income`
724- `balancesheet`
725- `cashflow`
726- `forecast`
727- `express`
728- `moneyflow`
729- `moneyflow_hsgt`
730- `hsgt_top10`
731- `top_list`
732- `index_basic`
733- `index_daily`
734- `index_classify`
735- `sw_daily`
736- `ths_index`
737- `ths_member`
738- `limit_list_d`
739- `limit_step`
740- `news`
741- `major_news`
742- `research_report`
743- `anns_d`
744- `cn_cpi`
745- `cn_pmi`
746- `us_tycr`
747 
748全部数据接口，请参考 `references/数据接口.md`。
749 
750***
751 
752## Best practices
753 
754- 先理解任务，再选接口
755- 能少取就少取，先核心数据，再扩展
756- 先给结论，再给证据
757- 默认说人话，不堆字段名
758- 对“最近 / 财报 / 强不强 / 资金关注”这类模糊中文表达，要有合理默认口径
759- 大任务先给执行计划，再开跑
760- 导出任务尽量保留脚本、元信息、文件路径，方便复用
761 
762***
763 
764## Examples
765 
766### 单票行情
767 
768- 看下宁德时代最近三个月走势
769- 茅台今年以来涨了多少
770- 招行这两年最大回撤大概多少
771 
772### 财务 / 估值
773 
774- 看下比亚迪最近 8 个季度营收和净利润趋势
775- 茅台现在估值算高吗
776- 帮我找高 ROE 低负债的公司
777 
778### 对比
779 
780- 比一下茅台、五粮液、泸州老窖近一年的涨幅和估值
781- 对比一下沪深300、中证500、创业板今年表现
782 
783### 资金流 / 板块
784 
785- 今天北向资金流入最多的股票有哪些
786- 最近哪个板块最强
787- 半导体板块最近一个月强不强
788 
789### 公告 / 事件
790 
791- 帮我梳理下寒武纪最近的重要公告
792- 最近机器人板块有什么消息面催化
793 
794### 宏观
795 
796- 看一下最近 CPI、PPI、PMI 变化
797- 当前市场风格偏成长还是价值
798 
799### 导出
800 
801- 把沪深300成分股近两年日线导成 CSV
802- 下载宁德时代 2020 到现在的复权行情
803- 把最近 3 年 ROE、PE、PB、营收增速拉成一个表
804 
805***
806 
807## Quick rule
808 
809当用户在说：
810 
811- 看走势
812- 查财报
813- 比较公司
814- 看板块
815- 看资金流
816- 梳理公告新闻
817- 看宏观
818- 拉数据导出
819 
820就不要先想“有哪些接口”。
821先想：
822**这是什么任务？默认该走哪条数据工作流？结果应该怎样交付才真正有用？**
823