新增三大股东接口, 补充 SKILLS.md 使用说明书

- 新增 十大流通股东/十大股东明细/股东户数 三个抓取模块并接入 API
- 冒烟测试扩展至 30 用例, 全部通过
- 新增 SKILLS.md (给其他 agent 使用的工具说明书)
- 补充待优化端点清单与文档对齐规范

docs/api_manual.md

@@ -253,6 +253,38 @@ curl "http://127.0.0.1:8765/fin/dividend-statics?stocks=603233.SH&years=5"
 
 ---
 
+## 8. 股东数据（十大流通股东 / 十大股东明细 / 股东户数）
+
+**公共参数**
+
+| 参数 | 类型 | 必填 | 默认 | 说明 |
+|---|---|---|---|---|
+| `stocks` | string | ✅ | — | 逗号分隔股票代码，如 `603233.SH`。仅需代码，不需要 ORG_CODE |
+| `years` | int | | `3` | 拉取最近多少年的数据（1~20） |
+
+**示例**
+
+```bash
+# 十大流通股东
+curl "http://127.0.0.1:8765/fin/free-holders?stocks=603233.SH&years=3"
+
+# 十大股东明细
+curl "http://127.0.0.1:8765/fin/holders?stocks=603233.SH&years=3"
+
+# 股东户数
+curl "http://127.0.0.1:8765/fin/holder-num?stocks=603233.SH&years=3"
+```
+
+**各接口常见列**
+
+| 接口 | 常见列 |
+|---|---|
+| 十大流通股东 | `HOLDER_NAME`（股东名）、`HOLD_NUM`（持股数）、`HOLD_RATIO`、`FREE_HOLDNUM_RATIO`（占流通股比）、`HOLD_CHANGE` 等 |
+| 十大股东明细 | `RANK`（排名）、`HOLDER_NAME`、`HOLD_NUM`、`HOLD_RATIO`、`DIRECTION`（增减持方向）、`NOTICE_DATE` 等 |
+| 股东户数 | `HOLDER_TOTAL_NUM`（股东总数）、`HOLDER_TOTAL_NUMCHANGE`（户数增减）、`AVG_TOTAL_SHARES`（户均持股）等 |
+
+---
+
 ## 接口一览
 
 | 路径 | 功能 | 数据来源报表 |
@@ -271,9 +303,12 @@ curl "http://127.0.0.1:8765/fin/dividend-statics?stocks=603233.SH&years=5"
 | `/fin/dupont` | 杜邦分析 | `RPT_HSF9_FINA_DUPONT` |
 | `/fin/dividend-detail` | 分红明细 | `RPT_HSF9_ASSIGNPLAN_DETAIL` |
 | `/fin/dividend-statics` | 分红统计 | `RPT_HSF9_ASSIGNPLAN_STATICS` |
+| `/fin/free-holders` | 十大流通股东 | `RPT_F10_EH_FREEHOLDERS` |
+| `/fin/holders` | 十大股东明细 | `RPT_DMSK_HOLDERS` |
+| `/fin/holder-num` | 股东户数 | `RPT_F10_EH_HOLDERNUM` |
 
 ## 测试
 
 ```bash
-uv run pytest tests/ -q   # 冒烟测试: 连真实接口验证各模块能取到数据
+uv run pytest tests/ -q   # 冒烟测试: 连真实接口验证各模块能取到数据 (30 用例)
 ```