yejinlei quantflow-skill
把自然语言财经数据请求，转成可执行的 Akshare 数据工作流。
这是一个面向自然语言的金融数据研究 skill。
What this skill is for
使用场景：
- 看股票、指数、ETF 走势
- 查公司资料、估值、财务趋势
- 多标的横向对比
- 看资金流、板块强弱
- 梳理公告、新闻、政策
- 查看宏观经济数据
- 查看期货实时行情和历史数据
- 查看期货主力合约数据
- 查看期权数据
- 查看基金数据
- 查看外汇数据
- 查看债券数据
- 查看加密货币数据
- 查看行业经济数据
- 查看全球经济数据
- 查看新能源数据
- 查看数字经济数据
- 查看金融市场数据
- 查看房地产数据
- 查看交通运输数据
- 查看农业数据
- 查看股票实时行情数据
- 导出数据供分析或回测
- 使用 AKQuant 进行策略回测
What this skill is NOT for
不适合：
- 直接给买卖建议或替代投资顾问
- 自动下单或执行交易
- 毫秒级实时交易决策
- 复杂回测引擎的实现
- 无网络支持时伪造数据
Environment check
前置校验：
- 检查 Python 3.7+ 可用
- 检查 akshare 包已安装
- 必要时检查 akquant 包已安装
缺失包时提示安装命令：
pip install aksharepip install akquant
Intent taxonomy
任务类型与核心接口：
1. 行情 / 趋势
- 核心接口：
stock_zh_a_hist,stock_zh_a_spot,stock_zh_a_daily,get_real_time_data(实时数据获取)
2. 基本资料 / 标的识别
- 核心接口：
stock_info_a_code_name,stock_company_info_em
3. 财务 / 公司质量
- 核心接口：
stock_financial_analysis_indicator,stock_balance_sheet_by_report_em
4. 估值 / 基本面指标
- 核心接口：
stock_zh_a_spot,stock_financial_analysis_indicator
5. 资金流 / 市场行为
- 核心接口：
stock_em_flows,stock_hsgt_hold,stock_top_inst
6. 板块 / 指数 / 主题
- 核心接口：
stock_board_industry_spot_em,stock_board_concept_spot_em
7. 打板 / 情绪 / 活跃度
- 核心接口：
stock_limit_up_board_em,stock_market_activity_em
8. 公告 / 新闻 / 研报 / 政策
- 核心接口：
stock_news_em,stock_announcement
9. 宏观 / 跨市场
- 核心接口：
macro_china_cpi,macro_china_pmi,stock_us_spot,stock_hk_spot
10. 期货数据
- 核心接口：
futures_zh_realtime（期货实时行情）,futures_zh_daily（期货日线数据）,futures_contract_info_shfe（期货合约信息）,get_futures_real_time_data(期货实时数据获取)
11. 期权数据
- 核心接口：
option_zh_sina_spot（期权实时行情）,option_zh_sina_daily（期权日线数据）
12. 基金数据
- 核心接口：
fund_open_fund_info_em（开放式基金信息）,fund_etf_hist_sina（ETF历史数据）
13. 外汇数据
- 核心接口：
forex_spot_quote（外汇现货报价）,forex_rate_history（汇率历史数据）
14. 债券数据
- 核心接口：
bond_zh_cn_basic（中国债券基本信息）,bond_zh_cn_hist（中国债券历史数据）
15. 加密货币数据
- 核心接口：
crypto_currency_hist（加密货币历史数据）,crypto_currency_spot（加密货币实时行情）
16. 行业经济数据
- 核心接口：
industry_energy_thermal_power_generation（火力发电量）,industry_energy_thermal_power_installed_capacity（火力发电装机容量）
17. 全球经济数据
- 核心接口：
global_economic_indicator（全球经济指标）,global_economic_indicator_country（国家经济指标）
18. 新能源数据
- 核心接口：
new_energy_vehicle_sales（新能源汽车销量）,new_energy_vehicle_production（新能源汽车产量）
19. 数字经济数据
- 核心接口：
digital_economy_internet_user（互联网用户数）,digital_economy_mobile_user（移动用户数）
20. 金融市场数据
- 核心接口：
financial_market_interbank_rate（银行间利率）,financial_market_shibor（上海银行间同业拆放利率）
21. 房地产数据
- 核心接口：
real_estate_house_price（房价数据）,real_estate_investment（房地产投资数据）
22. 交通运输数据
- 核心接口：
transportation_air_passenger（航空客运量）,transportation_railway_freight（铁路货运量）
23. 农业数据
- 核心接口：
agriculture_grain_production（粮食产量）,agriculture_crop_planting_area（农作物种植面积）
24. 导出 / 研究准备
- 核心：统一输出规则与命名规范
25. 量化策略回测
- 核心接口：
stock_zh_a_daily,stock_zh_a_hist,futures_zh_daily,akquant库
Entity resolution rules
标的解析
- 优先识别股票名、代码、指数名、ETF 名、基金名
- 对中文简称先尝试匹配标准对象
- 重名时列出候选并澄清
- 证券代码统一为标准格式
市场识别
- 默认按 A 股理解，除非明确提到其他市场
- 指数、ETF、个股分开判断
时间默认值
- “最近走势” → 近 20 个交易日
- “最近一段时间” → 近 3 个月
- “财报 / 业绩” → 最近 8 个季度 + 最近年度
- “资金流最近” → 近 5～20 个交易日
- “宏观最近” → 最近 6～12 期
板块口径默认值
- 行业优先用申万 / 中信口径
- 概念优先同花顺 / 东方财富口径
- 依赖口径差异时明确说明
Input normalization rules
数据请求前规范化：
- 日期统一为
YYYY-MM-DD - 检查
start_date <= end_date - 未来日期自动裁剪到最近可用日期
- 裸代码如
000001需澄清或说明补全规则 - 冲突参数先裁决后传递
Data retrieval rules
文档先行
- 确认接口名、必填参数、可选参数、返回字段
字段确认
- 使用已知字段白名单或接口文档确认
- 字段不存在时明确说明
默认分段拉取
- 日线/周线/月线：按年或季度切片
- 财报：按年份/报告期切片
- 分钟数据：按月/周切片
- 大批量多标的：按标的分批 + 日期分段
重试与限流
- 仅对瞬时错误（网络抖动、超时、429）有限重试
- 批量拉取时加入节流
分段合并
- 合并、去重、按主键排序
- 记录失败分段并明确告知用户
Output contract
默认输出结构：
- 一句话结论
- 数据范围与口径
- 关键指标/表格
- 异常点/风险点/解释限制
- 本地输出文件路径
结果交付形态
- 小结果：Markdown 摘要 + 简短表格
- 中等数据表：CSV
- 大规模分析：Parquet
- 可复用流程：附 Python 脚本
- 可视化：输出图表或说明
元信息
生成数据文件时记录：
- 接口名、请求参数、拉取时间
- 数据行数、字段列表
- 失败分段/缺失情况
Data quality rules
数据拉取后检查：
- schema 校验
- 关键字段存在性检查
- 主键去重
- 固定排序
- 日期标准化
- 数值字段类型规范化
空结果处理
区分空表原因：
- 非交易日
- 区间无数据
- 股票未上市
- 参数错误
Cache and reuse rules
支持：
- 基础表缓存（股票列表、交易日历、指数基础信息）
- 增量更新，避免全量重拉
- 大任务断点续跑
- 结果文件规范命名
推荐命名格式：
daily_600519_2023-01-01_2023-12-31_2026-03-22.csvfinancial_300750_2026-03-22.parquet
缓存命中时说明来源。
Error handling
采用“人话 + 调试细节分层”方式输出错误。
用户可见层
- akshare 包未安装
- 当前接口需要网络连接
- 时间范围过大，已自动分段拉取
- 股票名称不唯一，请确认
- 结果为空，可能因为非交易日/标的未上市
调试层
必要时提供：
- 接口名、参数
- 失败分段
- 异常原文
部分成功原则
明确说明：
- 成功部分
- 失败部分
- 是否生成不完整结果
Recommended minimal interface set
核心接口集：
stock_zh_a_hist：A股历史行情stock_zh_a_spot：A股实时行情stock_info_a_code_name：股票代码和名称stock_financial_analysis_indicator：财务分析指标stock_balance_sheet_by_report_em：资产负债表stock_income_statement_by_report_em：利润表stock_em_flows：资金流向数据stock_hsgt_hold：沪深港通持股stock_board_industry_spot_em：行业板块行情stock_board_concept_spot_em：概念板块行情stock_limit_up_board_em：涨停板数据stock_news_em：股票新闻stock_announcement：股票公告macro_china_cpi：中国CPI数据macro_china_pmi：中国PMI数据stock_us_spot：美股实时行情stock_hk_spot：港股实时行情futures_zh_realtime：期货实时行情futures_zh_daily：期货日线数据futures_contract_info_shfe：期货合约信息option_zh_sina_spot：期权实时行情option_zh_sina_daily：期权日线数据fund_open_fund_info_em：开放式基金信息fund_etf_hist_sina：ETF历史数据forex_spot_quote：外汇现货报价forex_rate_history：汇率历史数据bond_zh_cn_basic：中国债券基本信息bond_zh_cn_hist：中国债券历史数据crypto_currency_hist：加密货币历史数据crypto_currency_spot：加密货币实时行情industry_energy_thermal_power_generation：火力发电量industry_energy_thermal_power_installed_capacity：火力发电装机容量global_economic_indicator：全球经济指标global_economic_indicator_country：国家经济指标new_energy_vehicle_sales：新能源汽车销量new_energy_vehicle_production：新能源汽车产量digital_economy_internet_user：互联网用户数digital_economy_mobile_user：移动用户数financial_market_interbank_rate：银行间利率financial_market_shibor：上海银行间同业拆放利率real_estate_house_price：房价数据real_estate_investment：房地产投资数据transportation_air_passenger：航空客运量transportation_railway_freight：铁路货运量agriculture_grain_production：粮食产量agriculture_crop_planting_area：农作物种植面积
Best practices
- 先理解任务，再选接口
- 先核心数据，再扩展
- 先给结论，再给证据
- 默认说人话，不堆字段名
- 对模糊中文表达有合理默认口径
- 大任务先给执行计划
- 导出任务保留脚本、元信息、文件路径
- 量化回测明确策略逻辑、时间范围和资金管理
- 回测结果结合交易成本和滑点分析
- 策略优化避免过拟合，使用样本外数据验证
Quick rule
当用户提到：
- 看走势
- 查财报
- 比较公司
- 看板块
- 看资金流
- 梳理公告新闻
- 看宏观
- 看期货行情
- 看期货实时行情
- 看期货主力合约
- 看期权数据
- 看基金数据
- 看外汇数据
- 看债券数据
- 看加密货币
- 看行业经济数据
- 看全球经济数据
- 看新能源数据
- 看数字经济数据
- 看金融市场数据
- 看房地产数据
- 看交通运输数据
- 看农业数据
- 看股票实时行情
- 实时价格
- 现在价格
- 当前行情
- 拉数据导出
- 测试交易策略
- 回测量化模型
先想： 这是什么任务？默认该走哪条数据工作流？结果应该怎样交付才真正有用？