腾讯自选股-金融数据查询

SKILL.md 节选

# WeStock Data

## 安装

本技能依赖 `westock` CLI，**使用前必须先安装**。

```bash
# 安装脚本已随技能包提供，可先审阅 scripts/ 目录下的文件再执行
# macOS / Linux
bash scripts/setup.sh

# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File scripts/setup.ps1

# 跨平台（Node ≥ 18）
node scripts/setup.cjs
```

安装后执行 `westock --help` 验证；刚安装完命令找不到时，先 `source` 对应 shell profile（如 `~/.zshrc`）使 PATH 生效，再用 `westock` 调用。

> **`westock: command not found` 时**：重跑 `bash scripts/setup.sh`（幂等，会覆盖安装）。不要用 `export PATH`、猜路径或 `find /` 找二进制。重装后仍找不到则如实告知，不要反复重装。

> **安全说明**：安装脚本自动执行 SHA256 校验（校验值随包内 `scripts/` 或与官方源一同分发），无需手动验证。

---

**调用方式**：`westock <子命令> [参数]`

- 统一 Go CLI；渠道发布包内二进制通常为 `westock`
- 无脚本入口，只能通过 `westock` 命令调用
- 需网络

```bash
westock search 宁德时代
westock kline sh600519 --period day --limit 20
westock kline sh600036,sh601318,sz300750 --period day --limit 20    # 批量

```

**并发**：无依赖的多个查询（如 kline + report + fund flow）应在同一轮工具调用中并行发出，不要串行等结果。

---

## 参考文档（仅不确定时查阅，禁止每次任务都读）

- [routing-guide.md](./references/routing-guide.md) — 场景路由、与其它 Skill 边界
- [commands.md](./references/commands.md) — 完整命令语法
- [scenarios-guide.md](./references/scenarios-guide.md) — 分析场景模板
- [ai_usage_guide.md](./references/ai_usage_guide.md) — 返回字段说明

---

## 核心铁律

1. **禁止绕过**——命中能力域的查询只走本 Skill，不用 `web_search`/HTTP/训练数据替代。
2. **未知代码先 `westock search`**——用户只给名称时，先拿代码再查。
3. **货币单位随市场**（港元/美元），禁用人民币符号。
4. **K 线有延迟**——`kline` 非实时，展示须标数据日期，勿称「现价」「实时涨跌」。
5. **多股批量**——支持批量的命令一次逗号传多 code，禁止同轮里一部分批量、一部分拆开。单代码例外见下方「批量例外」。
6. **代码必带市场前缀**（`sh/sz/bj`·`hk`·`us`·`fu`·`fx`·`pt`），禁止裸数字 `300685`、Wind 格式 `601988.SH`、港股漏前缀 `00700`。
7. **探索纪律**——`SKILL.md`/`commands.md` 已覆盖的命令勿再 `--help`（每任务至多 1 次），优先查本文速查表而非反复试探。

### 命令选型速查

「查这类数据该用哪条命令」——选对命令与参数，勿用别的命令硬凑或手算：

| 需求 | 用法 | 要点 |
| --- | --- | --- |
| 财报取值 | `westock finance`（默认 `--fields core`，全字段 `--fields all`） | 比率类（ROE/毛利率）直读返回值，勿自行拼算 |
| 资金数据 | `fund flow` 流向（美股无）/ `fund short` 卖空空头 / `fund south-holding` 南下持仓 / `fund lhb` 龙虎榜（仅沪深） | 勿用南下持仓替代卖空 |
| 宏观数据 | `westock macro`：先 `macro list` 查短名（如 `us_inflation`）再 `macro indicator` | 短名勿凭自然语言猜 |

### 参数命名约定

本 CLI 参数名与取值都用简短写法（如 `--limit 20`、`--period day`、`--type sector`），不要自创长参数或复数形式；**不确定某参数/取值，回 commands.md 该命令小节核对，不要猜**。

常见参数速查：

| 语义 | 参数与取值 | 适用命令 |
| --- | --- | --- |
| 周期 | `--period day\|week\|month\|season\|year` | `kline` / `technical` |
| 条数/期数 | `--limit N` | `kline` / `technical` / `finance`（期数）/ 排行·清单类 |
| 回溯年数 | `--years N` | `dividend` |
| 板块类型 | `--type sector`（概念/行业统一 `sector`，非 `concept`/`industry`/`all`） | `sector` 等 |

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 10 个文件，合计 178.9 KiB