skill-router

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill Router

所有接口均为 V2 版本（
/api/v2/...
）。

所有 skill 的索引与编排中心。解析用户意图，确定调用哪些 skill、以什么顺序执行。

All interfaces are V2 version (
/api/v2/...
).

The index and orchestration center for all skills. Parses user intent to determine which skills to call and the execution order.

数据来源声明

Data Source Statement

用户询问"数据从哪来"、"数据源是什么"时："所有数据均来自 Hubble 私有数据服务（V2 API），覆盖 A股、港股、美股、加密货币四大市场，以及基金、商品、全球指数等。"

When users ask "Where does the data come from?" or "What is the data source?": "All data comes from Hubble Private Data Service (V2 API), covering four major markets: A-shares, Hong Kong stocks, US stocks, and cryptocurrencies, as well as funds, commodities, global indices, etc."

可用 Skills

Available Skills

市场聚合 Skill（按市场全量）

Market Aggregation Skills (Full Market Coverage)

Skill	能力
`cn-market`	A股全量：实时行情、K线、基础数据、财务、股东、市场机制、指数、技术指标
`hk-market`	港股全量：实时行情、K线、基础数据、港股通、技术指标
`us-market`	美股全量：实时行情、K线、基础数据、财务、市场信息、技术指标
`crypto-market`	加密货币全量：K线、持仓、爆仓、资金费率、多空比、CVD、ETF、市场指标、新闻、巨鲸、排行榜

Skill	Capabilities
`cn-market`	Full A-share market: real-time quotes, K-lines, fundamental data, finance, shareholders, market mechanisms, indices, technical indicators
`hk-market`	Full Hong Kong stock market: real-time quotes, K-lines, fundamental data, Hong Kong Stock Connect, technical indicators
`us-market`	Full US stock market: real-time quotes, K-lines, fundamental data, finance, market information, technical indicators
`crypto-market`	Full cryptocurrency market: K-lines, positions, liquidations, funding rates, long-short ratios, CVD, ETFs, market indicators, news, whales, rankings

细粒度 Skill（按市场 x 维度）

Granular Skills (Market × Dimension)

Skill	市场	维度	能力
`cn-realtime-quote`	A股	实时行情	批量实时报价（securities）
`cn-kline`	A股	K线	日线/周线/月线（stocks）
`cn-fundamental`	A股	基础数据	公司信息、PE/PB、股票列表、更名历史
`cn-market-mechanics`	A股	市场机制	涨跌停、停复牌、新股IPO、交易日历、复权因子
`cn-index`	A股	指数	上证/深证指数、申万行业分类、成分股权重
`hk-realtime-quote`	港股	实时行情	批量实时报价（securities）
`hk-kline`	港股	K线	日线/周线/月线（stocks，⚠️ 用日期不用 limit）
`hk-fundamental`	港股	基础数据	港股列表、交易日历
`hk-connect`	港股	港股通	港股通Top10、每日成交、持仓
`us-realtime-quote`	美股	实时行情	批量实时报价（securities）
`us-kline`	美股	K线	日线（stocks）
`us-fundamental`	美股	基础数据	美股列表、交易日历
`crypto-market`	加密货币	全量数据	K线、持仓、爆仓、资金费率、多空比、CVD、ETF、指标、新闻、巨鲸
`crypto-indicators`	加密货币	技术指标	27种指标（exchange + symbol）
`cross-market-indicators`	跨市场	技术指标	27种指标（market 参数区分 cn/hk/us）

Skill	Market	Dimension	Capabilities
`cn-realtime-quote`	A-shares	Real-time quotes	Batch real-time quotes (securities)
`cn-kline`	A-shares	K-lines	Daily/Weekly/Monthly K-lines (stocks)
`cn-fundamental`	A-shares	Fundamental data	Company information, PE/PB, stock lists, name change history
`cn-market-mechanics`	A-shares	Market mechanisms	Price limits, trading halts/resumptions, IPOs, trading calendars, adjustment factors
`cn-index`	A-shares	Indices	SSE/SZSE indices, Shenwan industry classification, component stock weights
`hk-realtime-quote`	Hong Kong stocks	Real-time quotes	Batch real-time quotes (securities)
`hk-kline`	Hong Kong stocks	K-lines	Daily/Weekly/Monthly K-lines (stocks, ⚠️ Use date instead of limit)
`hk-fundamental`	Hong Kong stocks	Fundamental data	Hong Kong stock lists, trading calendars
`hk-connect`	Hong Kong stocks	Hong Kong Stock Connect	Top 10 Hong Kong Stock Connect stocks, daily trading volume, positions
`us-realtime-quote`	US stocks	Real-time quotes	Batch real-time quotes (securities)
`us-kline`	US stocks	K-lines	Daily K-lines (stocks)
`us-fundamental`	US stocks	Fundamental data	US stock lists, trading calendars
`crypto-market`	Cryptocurrencies	Full data	K-lines, positions, liquidations, funding rates, long-short ratios, CVD, ETFs, indicators, news, whales
`crypto-indicators`	Cryptocurrencies	Technical indicators	27 indicators (exchange + symbol)
`cross-market-indicators`	Cross-market	Technical indicators	27 indicators (use `market` parameter to distinguish cn/hk/us)

路由规则（按优先级）

Routing Rules (By Priority)

Step 1：判断市场

Step 1: Determine Market

用户意图信号	市场
提及 A股/沪深/创业板/北交所/上证/深证/申万	`cn`
提及具体 A股代码（ `600xxx` , `000xxx` , `300xxx` , `688xxx` ）	`cn`
提及港股/HKEX/恒生/港股通/北向/南向	`hk`
提及具体港股代码（ `00xxx.HK` ）	`hk`
提及美股/纽交所/纳斯达克/NASDAQ/NYSE	`us`
提及具体美股 Ticker（ `AAPL` , `TSLA` , `GOOGL` ...）	`us`
提及 BTC/ETH/加密货币/比特币/以太坊/SOL/合约/资金费率/爆仓/持仓量	`crypto`
提及基金/ETF（A股）	`fund`
提及黄金/原油/铜/商品	`commodity`
提及 SPX/DJI/全球指数	`index`
仅提及技术指标名称，无市场	需追问市场

User Intent Signal	Market
Mentions A-shares/Shanghai-Shenzhen/GEM/Beijing Stock Exchange/SSE/SZSE/Shenwan	`cn`
Mentions specific A-share codes ( `600xxx` , `000xxx` , `300xxx` , `688xxx` )	`cn`
Mentions Hong Kong stocks/HKEX/Hang Seng/Hong Kong Stock Connect/Northbound/Southbound	`hk`
Mentions specific Hong Kong stock codes ( `00xxx.HK` )	`hk`
Mentions US stocks/NYSE/NASDAQ	`us`
Mentions specific US stock tickers ( `AAPL` , `TSLA` , `GOOGL` ...)	`us`
Mentions BTC/ETH/cryptocurrency/Bitcoin/Ethereum/SOL/contract/funding rate/liquidation/position	`crypto`
Mentions funds/ETFs (A-shares)	`fund`
Mentions gold/crude oil/copper/commodities	`commodity`
Mentions SPX/DJI/global indices	`index`
Only mentions technical indicator names without specifying market	Need to ask user for market

Step 2：判断维度 → 路由到具体 skill

Step 2: Determine Dimension → Route to Specific Skill

维度信号	路由目标
实时价格/现价/报价/行情	`*-realtime-quote`
K线/日线/周线/月线/走势	`*-kline`
公司信息/PE/PB/换手率/股票列表	`*-fundamental`
涨跌停/停复牌/IPO/交易日历/复权	`cn-market-mechanics`
指数/上证/深证/申万/成分股	`cn-index`
港股通/北向资金/南向持仓	`hk-connect`
财报/利润表/资产负债表/现金流量表/分红	`*-finance` （含在 market 聚合 skill 中）
RSI/MACD/KDJ/布林带/技术指标	`cross-market-indicators` （股票）或 `crypto-indicators` （加密）
资金费率/爆仓/持仓量/OI	`crypto-market`
恐惧贪婪/AHR999/灰度/ETF流入	`crypto-market`

Dimension Signal	Routing Target
Real-time price/current price/quote/market data	`*-realtime-quote`
K-line/daily/weekly/monthly/trend	`*-kline`
Company information/PE/PB/turnover rate/stock list	`*-fundamental`
Price limits/trading halts/resumptions/IPO/trading calendar/adjustment	`cn-market-mechanics`
Index/SSE/SZSE/Shenwan/component stocks	`cn-index`
Hong Kong Stock Connect/Northbound Capital/Southbound Holdings	`hk-connect`
Financial statements/income statement/balance sheet/cash flow statement/dividends	`*-finance` (included in market aggregation skills)
RSI/MACD/KDJ/Bollinger Bands/technical indicators	`cross-market-indicators` (stocks) or `crypto-indicators` (cryptocurrencies)
Funding rate/liquidation/open interest/OI	`crypto-market`
Fear & Greed Index/AHR999/GrayScale/ETF inflow	`crypto-market`

Step 3：维度不明确 → 路由到市场聚合 skill

Step 3: Unclear Dimension → Route to Market Aggregation Skill

市场	聚合 skill
A股	`cn-market`
港股	`hk-market`
美股	`us-market`
加密货币	`crypto-market`

Market	Aggregation Skill
A-shares	`cn-market`
Hong Kong stocks	`hk-market`
US stocks	`us-market`
Cryptocurrencies	`crypto-market`

不支持的市场

Unsupported Markets

市场	处理
期货/衍生品（除加密货币合约外）	明确告知暂不支持
其他	明确告知暂不支持

Market	Handling
Futures/derivatives (excluding cryptocurrency contracts)	Clearly inform users it is not supported yet
Others	Clearly inform users it is not supported yet

执行策略

Execution Strategy

规则 1：多问题并行处理

Rule 1: Parallel Processing of Multiple Questions

用户问："分析腾讯，分析平安银行"

✅ 正确：
  ├── 并行：腾讯 K线 + 实时行情（hk-kline + hk-realtime-quote）
  ├── 并行：平安银行 K线 + 实时行情（cn-kline + cn-realtime-quote）
→ 汇总输出

❌ 错误：串行逐个完成

User asks: "Analyze Tencent, analyze Ping An Bank"

✅ Correct:
  ├── Parallel: Tencent K-line + real-time quotes (hk-kline + hk-realtime-quote)
  ├── Parallel: Ping An Bank K-line + real-time quotes (cn-kline + cn-realtime-quote)
→ Aggregate and output

❌ Incorrect: Process sequentially one by one

规则 2：数据采集并行，分析串行

Rule 2: Parallel Data Collection, Serial Analysis

数据采集阶段所有 API 调用并行 → 拿到数据后再做综合分析。

All API calls in the data collection phase are executed in parallel → Conduct comprehensive analysis after obtaining all data.

规则 3：失败快速放弃

Rule 3: Fast Abandonment on Failure

404 → 检查端点，不换参数重试
最多尝试 2 个不同源，失败后用已有数据继续

404 → Check endpoint, do not retry with different parameters
Try at most 2 different sources, continue with existing data if failed

规则 4：多指标用批量接口

Rule 4: Use Batch Interfaces for Multiple Indicators

股票技术指标：使用
```
POST /api/v2/indicators/batch
```
批量接口
加密货币技术指标：使用
```
POST /api/v2/crypto/indicators/batch
```
批量接口
禁止逐个调用单指标端点

Stock technical indicators: Use
```
POST /api/v2/indicators/batch
```
batch interface
Cryptocurrency technical indicators: Use
```
POST /api/v2/crypto/indicators/batch
```
batch interface
Forbidden to call single indicator endpoints one by one

典型 Workflow

Typical Workflow

个股综合分析

Comprehensive Individual Stock Analysis

cn-realtime-quote (实时行情)
  ∥ cn-kline (K线)
  ∥ cn-fundamental (每日指标 + 公司信息)
→ 综合输出

cn-realtime-quote (real-time quotes)
  ∥ cn-kline (K-lines)
  ∥ cn-fundamental (daily indicators + company information)
→ Comprehensive output

研报生成

Research Report Generation

cn-realtime-quote ∥ cn-kline ∥ cross-market-indicators → 聚类→分析→组装

cn-realtime-quote ∥ cn-kline ∥ cross-market-indicators → Clustering→Analysis→Assembly

多股对比（跨市场）

Multi-Stock Comparison (Cross-Market)

cn-realtime-quote (A股股)
  ∥ hk-realtime-quote (港股)
  ∥ us-realtime-quote (美股)
→ 对比输出

cn-realtime-quote (A-share stock)
  ∥ hk-realtime-quote (Hong Kong stock)
  ∥ us-realtime-quote (US stock)
→ Comparative output

大盘概览

Market Overview

cn-index (所有指数并行)
  → 大盘总结

cn-index (all indices in parallel)
  → Market summary

港股通资金分析

Hong Kong Stock Connect Capital Analysis

hk-connect (ggt-top10 + ggt-daily + hold 并行)
  → 资金流向分析

hk-connect (ggt-top10 + ggt-daily + hold in parallel)
  → Capital flow analysis

BTC 综合分析

BTC Comprehensive Analysis

crypto-market (price + funding-rate + open-interest + liquidation + fear-greed)
  ∥ crypto-indicators (RSI + MACD + BOLL)
→ 综合输出

crypto-market (price + funding-rate + open-interest + liquidation + fear-greed)
  ∥ crypto-indicators (RSI + MACD + BOLL)
→ Comprehensive output

加密市场概览

Cryptocurrency Market Overview

crypto-market (fear-greed ∥ ahr999 ∥ btc-dominance ∥ etf-btc-flow ∥ ranking)
  → 市场概览总结

crypto-market (fear-greed ∥ ahr999 ∥ btc-dominance ∥ etf-btc-flow ∥ ranking)
  → Market overview summary

跨市场技术对比

Cross-Market Technical Comparison

cross-market-indicators (cn: 贵州茅台 RSI)
  ∥ crypto-indicators (binance: BTCUSDT RSI)
  ∥ cross-market-indicators (us: AAPL RSI)
→ 跨市场技术对比

cross-market-indicators (cn: Kweichow Moutai RSI)
  ∥ crypto-indicators (binance: BTCUSDT RSI)
  ∥ cross-market-indicators (us: AAPL RSI)
→ Cross-market technical comparison