A Share Futures Analysis

---
name: a-share-futures-analysis
description: 股指期货/期现价差分析。当用户说"股指期货"、"IF"、"IC"、"IM"、"IH"、"期指"、"基差"、"期现价差"、"升水"、"贴水"、"futures"、"期货贴水多少"、"对冲"、"期现套利"时触发。分析股指期货（IF沪深300/IC中证500/IH上证50/IM中证1000）的基差变化、期限结构、持仓变动，辅助判断市场情绪和套利机会。支持研报风格（formal）和快速查看风格（brief）。
---

### 数据源
```bash
SCRIPTS="$SKILLS_ROOT/cn-stock-data/scripts"

# 现货指数实时行情（IF/IH/IC/IM 对应现货）
python "$SCRIPTS/cn_stock_data.py" quote --code SH000300,SH000016,SH000905,SH000852
# SH000300=沪深300(IF), SH000016=上证50(IH), SH000905=中证500(IC), SH000852=中证1000(IM)

# 现货指数K线（近30个交易日，用于计算均线和走势对比）
python "$SCRIPTS/cn_stock_data.py" kline --code SH000300 --freq daily --start [30日前日期]
```

```python
# 股指期货行情（akshare）
import akshare as ak

# 当月合约日线行情（symbol 格式：品种代码+0 表示当月连续）
df_if = ak.futures_zh_daily_sina(symbol='IF0')   # IF当月连续
df_ih = ak.futures_zh_daily_sina(symbol='IH0')   # IH当月连续
df_ic = ak.futures_zh_daily_sina(symbol='IC0')   # IC当月连续
df_im = ak.futures_zh_daily_sina(symbol='IM0')   # IM当月连续

# 下月合约：IF1, IH1, IC1, IM1
# 当季合约：IF2, IH2, IC2, IM2
# 下季合约：IF3, IH3, IC3, IM3

# 具体合约（如 IF2603 = 2026年3月合约）
df_contract = ak.futures_zh_daily_sina(symbol='IF2603')
```

**web 搜索补充**（数据源无法覆盖的关键信息）：
- 各品种当日实时期货价格（当月/下月/当季/下季）
- 前20名席位多空持仓数据及日变化
- 当日基差/升贴水具体数值
- 交割日日历（每月第三个周五）
- 市场对冲需求新闻（如量化对冲基金动态）

### Workflow (5 steps):

**Step 1: 期指+现货数据获取**
获取四大股指期货品种的当月/下月/当季/下季合约行情，以及对应现货指数实时报价：
| 品种 | 期货代码 | 对应现货 | 现货代码 | 合约月份 |
|------|---------|---------|---------|---------|
| IF | IF0/IF1/IF2/IF3 | 沪深300 | SH000300 | 当月/下月/当季/下季 |
| IH | IH0/IH1/IH2/IH3 | 上证50 | SH000016 | 当月/下月/当季/下季 |
| IC | IC0/IC1/IC2/IC3 | 中证500 | SH000905 | 当月/下月/当季/下季 |
| IM | IM0/IM1/IM2/IM3 | 中证1000 | SH000852 | 当月/下月/当季/下季 |

**Step 2: 基差计算**
计算各品种基差及年化基差率：
- **基差** = 期货价格 - 现货指数点位
- **基差率** = 基差 / 现货指数 * 100%
- **年化基差率** = 基差率 / 剩余交易日 * 250 * 100%（用于跨合约对比）
- 正基差（升水/contango）：期货 > 现货，通常反映乐观预期或资金成本
- 负基差（贴水/backwardation）：期货 < 现货，通常反映悲观情绪或对冲压力

输出基差表：
| 品种 | 当月基差 | 当月年化(%) | 下月基差 | 下月年化(%) | 贴水/升水 |
|------|---------|-----------|---------|-----------|----------|

**Step 3: 期限结构分析**
分析同一品种四个合约的价格排列：
- **正向结构（contango）**：远月 > 近月，正常市场状态，反映持有成本
- **反向结构（backwardation）**：远月 < 近月，反映强烈看空或对冲需求旺盛
- **结构变化**：与前一交易日/上周对比，结构是否在收敛或扩散
- 各品种期限结构图示（文字描述价差变化趋势）

**Step 4: 持仓分析**
通过 web 搜索获取前20名席位持仓数据：
- 多头持仓量、空头持仓量及日变化
- 净多/净空 = 多头持仓 - 空头持仓
- 多空持仓比 = 多头持仓 / 空头持仓
- 关注重点：净空头扩大→机构加空看跌；净多头扩大→机构加多看涨
- 席位变化：哪些席位（中信/华泰/中金等）在加仓/减仓

**Step 5: 综合研判 & 输出**
汇总分析，给出市场情绪判断：
- **基差信号**：深度贴水→悲观（但不等于一定下跌），升水→偏乐观
- **结构信号**：反向结构→短期压力大，正向结构→市场常态
- **持仓信号**：净空扩大→机构偏空，净多扩大→机构偏多
- **综合判断**：多空力量对比、情绪偏向、需关注的风险点
- **套利机会**（formal 模式）：期现套利空间、跨期价差交易机会

### 风格说明
| 维度 | formal（策略报告） | brief（快速查看） |
|------|------------------|-----------------|
| 品种覆盖 | IF/IH/IC/IM 全品种分析 | 仅用户指定品种或 IF+IC |
| 合约覆盖 | 当月/下月/当季/下季全分析 | 仅当月合约 |
| 基差分析 | 基差+年化基差率+历史分位 | 基差及升贴水方向 |
| 期限结构 | 完整结构分析+变化趋势 | 正向/反向一句话 |
| 持仓分析 | 前20席位多空+主力变化 | 净多/净空方向 |
| 套利分析 | 期现套利+跨期价差机会 | 无 |
| 结论 | 客观多空分析+风险提示 | 情绪方向判断 |
| 免责声明 | 需要（期货高风险） | 不需要 |

默认风格：**brief**

### 关键规则
1. **贴水不等于一定跌**：贴水反映悲观情绪和对冲压力，但基差有均值回归特性，深度贴水也可能是超卖信号
2. **交割日效应**：每月第三个周五为交割日，交割日前后波动通常加大，基差会向零收敛
3. **基差有回归特性**：到期日基差必然收敛为零（期货向现货靠拢），这是期现套利的基础
4. **参与门槛提示**：股指期货开户门槛50万+验资+知识测试+交易经验，保证金比例约12%-15%，杠杆约7-8倍，需提示风险
5. **IC/IM 长期贴水**：中证500/中证1000期货长期处于贴水状态，这是A股特有现象，主要因量化对冲需求旺盛
6. **与其他 skill 联动**：现货走势分析用 a-share-index-analysis，北向资金用 a-share-northbound，市场情绪综合用 a-share-sentiment

## 使用示例

### 示例 1: 基本使用

```python
# 调用 skill
result = run_skill({
    "param1": "value1",
    "param2": "value2"
})
```

### 示例 2: 命令行使用

```bash
python scripts/run_skill.py --input data.json
```