前言¶
做期货相关开发时，常见的重复工作是：先找数据源，再写指标计算，再拼报告格式，最后接推送。每一步都有现成的库，但串起来要花不少时间。AkShare 和天勤 TQ SDK 分别覆盖免费行情和实盘场景，技术指标也有成熟实现，缺的是把这几件事打包成一个可直接调用的技能。
下面介绍的「期货数据分析技能」就是做这件事的。它是社区发布的通用 SKILL.md 格式技能，坐标 @user_31675b53/futures-data-analysis，由 user_31675b53 发布并维护，版本 1.0.0。技能目标不是做交易系统，而是把行情获取、指标计算、多因子评分、AI 信号和报告推送串成一条固定流程，减少每次分析时的搭建成本。
这是什么¶
一句话定位：面向期货合约的数据分析技能，输入合约或分析需求，输出带开仓、止损止盈、平仓计划的结构化综合分析报告，并支持推送到飞书。
它属于 SkillHub 上的 data-analysis 分类，来源标记为 community。已抓取资料显示，当前页面评分 100000，下载 5708，安装 0，标签 requires_api_key=true。说明该技能依赖外部 API Key，配置前需要先准备好对应服务凭据。
核心功能¶
按已核实的能力整理，技能覆盖五段流程：
1、行情获取：支持 AkShare（免费）和天勤 TQ SDK（实盘）两个数据源，按使用场景选择。
2、技术指标：计算 MA、RSI、MACD、BOLL、KDJ、ATR，覆盖常用趋势、动量、波动率指标。
3、多因子评分：对期货合约执行多因子多空评分，给出方向性判断。
4、AI 信号：生成 AI 驱动的交易信号，支持 DeepSeek、百炼、魔搭多引擎热备，避免单一模型不可用时中断。
5、报告与推送：输出结构化综合分析报告，内容包含开仓点位、止损止盈、平仓计划，并支持飞书推送。
这几项能力对应简介中的描述。技能还给出了适用触发场景：分析期货合约、生成期货交易报告、筛选期货市场、计算期货技术指标、把期货分析报告推送到飞书。实际使用范围以技能内部实现为准。
安装与启用¶
已抓取资料中没有给出官方安装命令、目录结构或具体配置字段，官方页面在本次写作时也无法访问，因此这里不臆造命令。下面只说明启用前必须确认的两件事，具体安装步骤以官方页面为准。
# 1、确认 SkillHub 上的坐标与版本
坐标：@user_31675b53/futures-data-analysis
版本：1.0.0
分类：data-analysis
# 2、确认外部依赖的凭据
标签：requires_api_key=true
说明：需要 AI 引擎的 API Key，按 DeepSeek / 百炼 / 魔搭 中实际使用的服务配置
第一段的作用是核对技能坐标和版本，避免装错或装到同名技能。第二段的作用是确认 API Key 来源。AI 信号部分支持多引擎热备，配置时至少要保证其中一个引擎可用；如果只用单一引擎，就不存在热备能力。AkShare 与天勤 TQ SDK 的安装方式、TQ SDK 的账号和行情授权，需按各自官方文档处理。
典型用法¶
已抓取资料只提供了技能简介，没有给出可复现的输入示例、输出样例或命令行调用方式，因此本节不写示例，只列出技能声称支持的任务类型。要用它完成一次分析，建议按下面顺序确认：
1、明确目标合约和分析目的，是单合约分析、市场筛选，还是报告推送。
2、确认数据源，免费回测走 AkShare，实盘相关走天勤 TQ SDK。
3、确认 AI 引擎与 API Key 已配置，并选定主引擎和备用引擎。
4、按技能说明提交分析请求，获取结构化报告。
5、如需推送，配置飞书相关参数后触发推送。
以上步骤是按技能功能反推的最小流程，不代表官方给出的具体调用形式。可复现示例需要以官方页面或技能内部 SKILL.md 为准。
适用场景与注意¶
适合下面几类人：需要定期产出期货合约技术分析报告的开发者；想把行情、指标、评分、AI 信号和飞书通知串起来的个人或小团队；在 AkShare 免费数据与天勤 TQ SDK 实盘数据之间切换使用的人。
需要注意的限制：
1、技能依赖 API Key，没有配置或引擎不可用时，AI 信号部分会受影响。
2、多引擎热备是可用性机制，不改变信号本身的质量，模型差异仍会带来结果差异。
3、多因子评分和 AI 信号属于分析输出，不构成交易建议，实盘决策需要自行复核。
4、AkShare 与天勤 TQ SDK 的数据口径、更新频率和历史长度不同，混用时要做对齐。
5、官方页面本次无法访问，评分、下载和安装数可能与最新页面不一致，以 SkillHub 页面为准。
结尾¶
这个技能的价值在于把期货分析里分散的数据源、指标、评分、AI 信号和报告推送收进一个固定流程，减少每次分析的搭建成本。它适合需要可复用分析链路的开发者，不适合替代完整的风控和交易执行系统。官方地址：https://api.skillhub.cn/user_31675b53/futures-data-analysis，SkillHub 页面：https://www.skillhub.cn/skills/user_31675b53/futures-data-analysis。
