Akshare Router Cn

# akshare-router-cn

面向中文用户的「AKShare 数据路由器」skill：把期货/期权问题按 **频率(实时/分钟/日频)** → **品类(期货/期权)** → **是否需要二次加工(指标/Greeks/RR25)** 三步分流到最合适的数据源与 recipe。

> 一期只覆盖 **免费可用源**：东方财富/新浪等公开页面对应的 AKShare 接口。**不包含奇货可查/付费源**。

---

## 你要做的事（路由协议，必须遵守）

当用户提问时：

### Step 0：抽取意图槽位
- `freq`：realtime | intraday(minute) | daily/历史
- `asset`：futures | options
- `need_compute`：none | indicators | greeks_iv | rr25 | (组合)
- `scope`：单合约 | 品种全合约 | 全市场/列表

### Step 1：先判频率（实时优先）
- 命中【实时/盘面/盘口/最新价/当前/成交量/持仓/分时/分钟/5m/30m】→ `realtime` 或 `intraday`
- 命中【日线/历史/从…到…/近一年/回测】→ `daily/历史`

### Step 2：再判品类（期货 vs 期权）
- 命中【期货/主连/次主连/合约如 IF2403/ RB主连】→ futures
- 命中【期权/看涨/看跌/行权价/隐含波动率/Delta/Gamma】→ options

### Step 3：最后判是否二次加工
- 命中【MA/EMA/MACD/RSI/布林/ATR/5m指标/30m指标】→ indicators
- 命中【隐含波动率/IV/Delta/Gamma/Theta/Vega/Rho】→ greeks_iv
- 命中【RR25/25D 风险逆转/Skew】→ rr25（需要 greeks_iv + 规则）

### Step 4：按需加载（只读需要的文件）
1) 先 `read maps/router.yml`：找到对应 recipe
2) 再 `read recipes/<name>.md`：按步骤执行
3) 如果 recipe 引用 method（例如 RR25/指标计算），再 `read methods/<name>.md`

---

## 入口路由表（文件）
- `maps/router.yml`：意图 → recipe 文件名（**唯一真源**）
- `maps/keywords.yml`：中文关键词归一化（减少误判）
- `references/INDEX.md`：AKShare 可用接口索引（只列一期用到的）

---

## MVP 覆盖的用户高频需求

### 期货
- 实时盘面/成交（某个品种所有合约）：`recipes/futures_realtime_board.md`
- 5m/30m 分钟线 + 技术指标：`recipes/futures_kline_indicators.md`

### 期权
- 隐含波动率 + Greeks（基于上交所 ETF 期权）：`recipes/options_iv_greeks.md`
- RR25（基于 Delta 近似）：`recipes/options_rr25.md`

---

## 运行方式（给会用工具的 agent）
- 数据抓取与计算脚本在 `scripts/`；可用 `exec` 运行，例如：
  - `python3 skills/akshare-ro...

# akshare-router-cn (MVP skeleton)

这是一个 **OpenClaw skill 骨架**：围绕 AKShare 的免费数据源，对「中国期货/期权」高频问题做 **路由 + 最小可用 recipe**。

- 目标：把问题 **快速分流** 到正确的数据源/计算方法，减少“翻 AKShare 文档/函数名”的成本。
- 范围（一期）：
  - 期货：实时盘口/成交、分钟线(1/5/30m)、日线；基础技术指标（MA/EMA/MACD/RSI 等，后处理）。
  - 期权：合约列表、实时价、隐含波动率、Greeks（来源：Sina 的 `option_sse_greeks_sina` 结构化字段）。
  - RR25：基于 Delta 近似（从 greeks 接口取 delta + IV），用“最接近 ±0.25 delta 的合约”近似。

入口文件：`SKILL.md`

> 注意：本目录是 skeleton；能力/字段随上游站点变动。所有不确定处已标记 TODO。