@hithink-tech/hithink-finance-cli 0.1.0

package/skills/hithink-finance-market/references/market-adjustment-factors.md

@@ -0,0 +1,33 @@
+# `hithink-finance market adjustment-factors`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema market.adjustment-factors --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 查询本地日级复权因子；需要本地库。
+
+## 命令
+
+```bash
+hithink-finance schema market.adjustment-factors --format json
+hithink-finance market adjustment-factors --thscode <code> --format json
+```
+
+## 参数选择策略
+
+- 必填 `--thscode <code>`；可选 `--start` / `--end`。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 日期必须是 `YYYY-MM-DD`；没有本地库先走 `data init|sync`。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-market/references/market-calendar.md

@@ -0,0 +1,35 @@
+# `hithink-finance market calendar`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema market.calendar --format json` 确认当前参数契约。
+- 远端命令需要 API Key；认证失败时回到 shared skill。
+
+## 命令
+
+```bash
+hithink-finance schema market.calendar --format json
+hithink-finance market calendar --format json
+```
+
+## 参数选择策略
+
+| 参数              | 必填 | 说明                                            |
+| ----------------- | ---- | ----------------------------------------------- |
+| `--output <path>` | 否   | write the full JSON response envelope to a file |
+
+## 窗口与分页
+
+- 单次请求窗口最多 1 年；超过时拆分或缩小范围。
+- 无分页参数；仍检查返回中的 count/数组长度。
+
+## 常见错误
+
+- 参数校验失败时按 `error.hint` 修正，不要猜字段名。
+- 认证失败时不要重试刷屏；先处理 API Key。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-market/references/market-corporate-actions.md

@@ -0,0 +1,38 @@
+# `hithink-finance market corporate-actions`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema market.corporate-actions --format json` 确认当前参数契约。
+- 远端命令需要 API Key；认证失败时回到 shared skill。
+
+## 命令
+
+```bash
+hithink-finance schema market.corporate-actions --format json
+hithink-finance market corporate-actions --thscode <code> --format json
+```
+
+## 参数选择策略
+
+| 参数                 | 必填 | 说明                                            |
+| -------------------- | ---- | ----------------------------------------------- |
+| `--thscode <code>`   | 是   | single A-share thscode                          |
+| `--from-date <date>` | 否   | first ex-date YYYY-MM-DD；上游参数: from        |
+| `--to-date <date>`   | 否   | last ex-date YYYY-MM-DD；上游参数: to           |
+| `--output <path>`    | 否   | write the full JSON response envelope to a file |
+
+## 窗口与分页
+
+- 无额外时间窗口限制，仍按命令参数和上游返回为准。
+- 无分页参数；仍检查返回中的 count/数组长度。
+
+## 常见错误
+
+- 参数校验失败时按 `error.hint` 修正，不要猜字段名。
+- 认证失败时不要重试刷屏；先处理 API Key。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-market/references/market-history.md

@@ -0,0 +1,39 @@
+# `hithink-finance market history`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema market.history --format json` 确认当前参数契约。
+- 远端命令需要 API Key；认证失败时回到 shared skill。
+
+## 命令
+
+```bash
+hithink-finance schema market.history --format json
+hithink-finance market history --thscode <code> --start-ms <milliseconds> --end-ms <milliseconds> --format json
+```
+
+## 参数选择策略
+
+| 参数                        | 必填 | 说明                                                          |
+| --------------------------- | ---- | ------------------------------------------------------------- |
+| `--thscode <code>`          | 是   | single A-share thscode                                        |
+| `--start-ms <milliseconds>` | 是   | start timestamp；上游参数: start                              |
+| `--end-ms <milliseconds>`   | 是   | end timestamp；上游参数: end                                  |
+| `--adjust <mode>`           | 否   | adjustment mode；可选: none, forward, backward；默认: forward |
+| `--output <path>`           | 否   | write the full JSON response envelope to a file               |
+
+## 窗口与分页
+
+- 单次请求窗口最多 10 年；超过时拆分为不重叠窗口并合并去重。
+- 无分页参数；仍检查返回中的 count/数组长度。
+
+## 常见错误
+
+- 参数校验失败时按 `error.hint` 修正，不要猜字段名。
+- 认证失败时不要重试刷屏；先处理 API Key。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-market/references/market-panel.md

@@ -0,0 +1,33 @@
+# `hithink-finance market panel`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema market.panel --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 需要本地库覆盖请求窗口；适合作为研究样本输入。
+
+## 命令
+
+```bash
+hithink-finance schema market.panel --format json
+hithink-finance market panel --start <date> --end <date> --output <path> --format json
+```
+
+## 参数选择策略
+
+- 必填 `--start YYYY-MM-DD --end YYYY-MM-DD --output <path>`；默认 parquet。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 日期必须是 `YYYY-MM-DD`；大面板永远落盘。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-market/references/market-snapshot.md

@@ -0,0 +1,39 @@
+# `hithink-finance market snapshot`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema market.snapshot --format json` 确认当前参数契约。
+- 远端命令需要 API Key；认证失败时回到 shared skill。
+
+## 命令
+
+```bash
+hithink-finance schema market.snapshot --format json
+hithink-finance market snapshot --format json
+hithink-finance market snapshot --codes-file codes.txt --output result.json --format json
+```
+
+## 参数选择策略
+
+| 参数                 | 必填 | 说明                                            |
+| -------------------- | ---- | ----------------------------------------------- |
+| `--thscodes <codes>` | 否   | comma-separated A-share thscodes                |
+| `--limit <number>`   | 否   | page size；默认: 100                            |
+| `--offset <number>`  | 否   | row offset；默认: 0                             |
+| `--output <path>`    | 否   | write the full JSON response envelope to a file |
+
+## 窗口与分页
+
+- 无额外时间窗口限制，仍按命令参数和上游返回为准。
+- 使用 `--limit` + `--offset` 翻页；全量抓取时循环到返回条数小于 limit。
+
+## 常见错误
+
+- 参数校验失败时按 `error.hint` 修正，不要猜字段名。
+- 认证失败时不要重试刷屏；先处理 API Key。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 支持 `--codes-file` 或 `--codes-stdin` 读取多 thscode；不要同时用 `--api-key-stdin` 和 `--codes-stdin`。

package/skills/hithink-finance-research/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: hithink-finance-research
+description: '用于 Agent 通过 hithink-finance CLI 基于已有本地数据做中立研究准备、面板导出、只读 SQL、描述性统计和可复现实证数据集；不用于实时取数、荐股、择时、组合建议或投资结论。'
+---
+
+# hithink-finance-research
+
+研究工作流路由。它不拥有独立 `research` 命令，而是指导 Agent 组合 data、db 和 market panel 产出可复现数据证据。
+
+## 前置条件表
+
+| 条件                                   | 操作                                                                                                  |
+| -------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| 开始任何 CLI 调用                      | 先读取并遵循 [hithink-finance-shared](../hithink-finance-shared/SKILL.md)                             |
+| 不确定命令是否存在或参数是否变化       | 运行 `hithink-finance capabilities --format json`，再运行 `hithink-finance schema <id> --format json` |
+| 需要执行下表某个命令                   | 先读取对应 reference 文件，不要只凭命令名猜参数                                                       |
+| 结果可能是全市场、分页、多标的或长区间 | 使用命令声明的 `--output <path>` 落盘；远端 stdout 只返回摘要                                         |
+
+## 快速决策
+
+| 用户意图                  | 首选命令 / 路由                                                        |
+| ------------------------- | ---------------------------------------------------------------------- |
+| 用户要构造研究样本/面板   | 先 `data status` 和 `data validate`，再 `market panel --output <file>` |
+| 用户要 SQL 统计或因子分布 | 用 `db query` 小结果或 `db export` 大结果                              |
+| 用户要解释数据缺口        | 先 `data validate`，必要时 `data sync` 或 `data repair`                |
+| 用户要实时快照或最新榜单  | 切到对应业务 skill，不在 research 中直接取数                           |
+| 用户要投资建议/策略推荐   | 拒绝给出建议，可提供中立数据分析边界                                   |
+
+## Shortcuts
+
+| 命令                                                    | 何时使用                                     |
+| ------------------------------------------------------- | -------------------------------------------- |
+| [research-workflow.md](references/research-workflow.md) | 组合 data/db/market panel 做中立研究数据准备 |
+
+## 原生命令与 schema
+
+```bash
+hithink-finance capabilities --format json
+hithink-finance schema <capability-id> --format json
+hithink-finance data <command> --help
+hithink-finance db <command> --help
+hithink-finance market panel --help
+```
+
+使用原生命令前必须先看 schema；schema 是当前 CLI 参数契约，reference 是决策和边界补充。
+
+## 权限表
+
+| 命令类型                       | 要求                                                                   |
+| ------------------------------ | ---------------------------------------------------------------------- |
+| 远端服务查询                   | API Key 来自系统凭据库、`HITHINK_FINANCE_API_KEY` 或 `--api-key-stdin` |
+| 本地 DuckDB 查询/导出          | 本地库存在且 schema 兼容；可用全局 `--db <path>` 指定                  |
+| 删除、迁移、修复等有副作用操作 | 先预览或说明影响；需要用户明确确认时才加 `--yes`                       |
+
+## 边界声明
+
+- 只做描述性、可复现、数据来源明确的研究辅助；不要生成买入/卖出/持有建议。
+- 必须保留查询 SQL、输入文件路径、输出路径、行数和时间窗口，便于复核。

package/skills/hithink-finance-research/references/research-workflow.md

@@ -0,0 +1,34 @@
+# research workflow
+
+## 前置条件
+
+- 先读取 [hithink-finance-shared](../../hithink-finance-shared/SKILL.md)。
+- 确认用户要的是中立研究数据、统计或可复现实证输入，不是投资建议。
+- 本地库状态未知时先运行 `hithink-finance data status --format json` 和 `hithink-finance data validate --format json`。
+
+## 命令
+
+```bash
+hithink-finance data status --format json
+hithink-finance data validate --format json
+hithink-finance market panel --start <YYYY-MM-DD> --end <YYYY-MM-DD> --output <panel.parquet> --file-format parquet --format json
+hithink-finance db query --sql "<readonly sql>" --format json
+hithink-finance db export --sql "<readonly sql>" --output <result.parquet> --file-format parquet --format json
+```
+
+## 参数选择策略
+
+- 小样本探索用 `db query`，并在 SQL 中显式 `LIMIT`。
+- 下游分析、全市场、长区间、多因子结果用 `db export` 或 `market panel`。
+- 研究报告必须记录 SQL、时间窗口、库路径或输出文件路径、行数。
+
+## 常见错误
+
+- 不要把相关性、排序或榜单解释成买卖建议。
+- 不要在研究 skill 中临时取实时榜单；切到对应业务 skill 后再把结果作为证据。
+- 不要修改数据库；研究 SQL 必须只读。
+
+## 批量操作说明
+
+- 分批导出时给每批文件命名，最终合并前按 `thscode/date` 等主键去重。
+- 最终回答只摘要统计结果和证据路径，不粘贴大表。

package/skills/hithink-finance-shared/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: hithink-finance-shared
+description: '用于 Agent 通过 hithink-finance CLI 做安装后自检、API Key 认证、配置、版本更新、诊断、卸载、Skills 安装/同步/移除，以及 JSON 输出、安全和大结果处理规则；不要用于行情、财务、指数、特色数据或研究取数。'
+---
+
+# hithink-finance-shared
+
+共享规则和生命周期入口。只放全局约束、认证、输出、安全、更新和 Skills 管理，不承载业务取数路由。
+
+## 前置条件表
+
+| 条件                            | 操作                                                                                         |
+| ------------------------------- | -------------------------------------------------------------------------------------------- |
+| 第一次接触此 CLI 或怀疑版本漂移 | 运行 `hithink-finance version --format json` 和 `hithink-finance capabilities --format json` |
+| 需要机器读取                    | 始终加 `--format json`                                                                       |
+| 结果可能很大                    | 使用命令声明的 `--output <path>` 落盘；远端 stdout 只返回摘要                                |
+| 需要远端同花顺金融数据服务      | 先确认 `auth status` 或准备 `HITHINK_FINANCE_API_KEY` / `--api-key-stdin`                    |
+
+## 快速决策
+
+| 用户意图                | 首选命令 / 路由                                                                                                                                                               |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 检查 CLI 是否可用或版本 | `hithink-finance version --format json`                                                                                                                                       |
+| 查看真实能力清单        | `hithink-finance capabilities --format json`                                                                                                                                  |
+| 查看某个命令参数契约    | `hithink-finance schema <capability-id> --format json`                                                                                                                        |
+| 获取并保存 API Key      | 先打开 https://fuyao.aicubes.cn/admin 获取 API Key，再运行 `hithink-finance auth login --api-key-stdin --format json`；交互终端也可运行 `hithink-finance auth login` 隐藏输入 |
+| 检查认证状态            | `hithink-finance auth status --format json`                                                                                                                                   |
+| 查看非敏感配置          | `hithink-finance config show --format json`                                                                                                                                   |
+| 诊断运行环境            | `hithink-finance doctor --format json`                                                                                                                                        |
+| 同步/修复配套 Skills    | `hithink-finance skills status --format json` 或 `hithink-finance skills sync --format json`                                                                                  |
+| 更新 CLI                | `hithink-finance update --check --format json` 或 `hithink-finance update --repair --format json`                                                                             |
+| 预览卸载                | `hithink-finance uninstall --plan --format json`                                                                                                                              |
+
+## References
+
+| 需要了解                           | 读取                                                    |
+| ---------------------------------- | ------------------------------------------------------- |
+| JSON 输出、大结果、安全规则        | [global-rules.md](references/global-rules.md)           |
+| API Key、profile、配置优先级       | [auth-and-config.md](references/auth-and-config.md)     |
+| version、doctor、update、uninstall | [lifecycle.md](references/lifecycle.md)                 |
+| skills status/sync/remove          | [skills-management.md](references/skills-management.md) |
+
+## 权限表
+
+| 能力                                          | 凭据                                              |
+| --------------------------------------------- | ------------------------------------------------- |
+| 本地 data/db/market panel                     | 通常不需要 API Key，除非需要同步或初始化远端 dump |
+| symbol/market remote/special/financials/index | 需要统一 API Key                                  |
+| skills/update/uninstall                       | 需要本机文件系统权限；不要写全局非 CLI 管理目录   |
+
+## 边界声明
+
+- 业务取数请求必须切到 symbol、market、special-data、financials、index、data 或 research skill。
+- 不要把 API Key 写入命令、配置文件、日志、Markdown、Git 或对话正文；优先 stdin 或系统凭据库。
+- 不要把 stderr 更新提示、诊断详情或完整大数据结果当作最终答案原样展开。

package/skills/hithink-finance-shared/references/auth-and-config.md

@@ -0,0 +1,31 @@
+# 认证和配置
+
+## 前置条件
+
+- API Key 只能来自系统凭据库、进程环境变量 `HITHINK_FINANCE_API_KEY`、stdin 或当前进程参数。
+- API Key 获取地址为 https://fuyao.aicubes.cn/admin；交互式用户可运行 `hithink-finance auth login`，CLI 会说明用途并隐藏输入。
+- 不要把密钥写入配置文件、日志、Git、Markdown 或对话正文。
+
+## 命令
+
+```bash
+hithink-finance auth login --api-key-stdin --format json
+hithink-finance auth login
+hithink-finance auth status --format json
+hithink-finance auth logout --format json
+hithink-finance config show --format json
+```
+
+## 参数选择策略
+
+- 交互式终端可用 `auth login` 隐藏输入。
+- 如果 `auth login` 提示已登录，需要切换 API Key 时先运行 `auth logout`，再重新登录。
+- Agent/CI 优先用 `--api-key-stdin` 或 `HITHINK_FINANCE_API_KEY`。
+- 多套凭据使用全局 `--profile <name>`。
+- `config show` 只显示非敏感项；不要期待它返回 API Key。
+
+## 常见错误
+
+- `AUTH_API_KEY_MISSING`：运行 `auth login` 或设置 `HITHINK_FINANCE_API_KEY`。
+- `CLI_MISSING_ARGUMENT`：非交互场景使用 `auth login --api-key-stdin`，不要把 API Key 写入对话或日志。
+- `CLI_CONFLICTING_ARGUMENTS`：不要同时传 `--api-key` 和 `--api-key-stdin`。

package/skills/hithink-finance-shared/references/global-rules.md

@@ -0,0 +1,21 @@
+# 全局规则
+
+## 前置条件
+
+- 优先运行 `hithink-finance capabilities --format json` 获取当前 CLI 事实。
+- 机器读取必须显式使用 `--format json`；需要表格给人看时才用 `table`。
+- `--output <path>` 只在声明该参数的具体命令上使用；远端能力命令会把完整 JSON envelope 写入文件，本地 `db export` / `market panel` 会写数据文件。它不是全局参数。
+
+## 输出契约
+
+- 成功以进程退出码 0 和 `ok: true` 为准。
+- 错误以非 0 退出码和 `ok: false` 为准；读取 `error.code`、`error.category`、`error.hint`。
+- 不要按上游旧格式 `code == 0` 判断成功。
+
+## 大结果纪律
+
+- 全市场、分页、长区间、多 ticker 数据不得回显完整内容。
+- 远端大结果用该命令自己的 `--output <path>`，stdout 只保留路径/count 摘要。
+- 本地大结果用 `db export --output <path>` 或 `market panel --output <path>`。
+- 最终回答只报告输出路径、行数、时间窗口、命令摘要和必要字段名。
+- 下游需要数据时让 pandas/notebook/脚本读取落盘文件。

package/skills/hithink-finance-shared/references/lifecycle.md

@@ -0,0 +1,23 @@
+# 生命周期命令
+
+## 命令
+
+```bash
+hithink-finance version --format json
+hithink-finance doctor --format json
+hithink-finance update --check --format json
+hithink-finance update --repair --format json
+hithink-finance uninstall --plan --format json
+```
+
+## 参数选择策略
+
+- 先 `update --check`，只有用户确认修复/升级时再 `update --repair`。
+- 卸载先 `uninstall --plan`，真实清理按计划和用户确认执行。
+- 直接 `npm uninstall -g` 不可靠清理 Agent Skill 目录；需要先运行 `hithink-finance uninstall --yes` 或 `hithink-finance skills remove`。
+- 诊断输出用于定位环境、路径、依赖和版本问题；不要把它当业务数据。
+
+## 常见错误
+
+- 普通命令可能在完成后向 stderr 输出更新提示；不要把它混入业务数据。
+- 不要因为更新提示中断取数、翻页或导出流程；需要升级时先运行 `update --check`，获得用户确认后再 `update --repair`。

package/skills/hithink-finance-shared/references/skills-management.md

@@ -0,0 +1,22 @@
+# Skills 管理
+
+## 命令
+
+```bash
+hithink-finance skills status --format json
+hithink-finance skills sync --format json
+hithink-finance skills remove --format json
+```
+
+## 参数选择策略
+
+- `status` 检查已安装 Skills 是否与 CLI 包内 manifest 一致。
+- `sync` 修复缺失或漂移的受管文件；用户改过的受管文件会备份。
+- `remove` 只移除本 CLI manifest 拥有的 8 个 skill，不做全局清空。
+- 若某个 Agent 不在自动安装范围内，读取 `status --format json` 的 `canonical` 目录，并把其中 8 个 `hithink-finance-*` 目录复制到该 Agent 文档声明的 skills 发现目录。
+
+## 常见错误
+
+- 自动安装可覆盖时，不要手工复制 skill 文件绕过 manifest；用 CLI 的 skills 子命令。
+- 手工兜底安装时，不要改名、拆分或只复制部分 reference 文件；保持整个 skill 目录原样复制。
+- 不要删除用户自建 skill 或非 hithink-finance 前缀 skill。

package/skills/hithink-finance-special-data/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: hithink-finance-special-data
+description: '用于 Agent 通过 hithink-finance CLI 查询特色数据：涨停池、连板天梯、个股异动、异动原因、飙升榜、热股榜、热度历史/趋势、龙虎榜、游资和机构榜；普通行情转 hithink-finance-market。'
+---
+
+# hithink-finance-special-data
+
+特色榜单和事件型数据入口。强调窗口约束和榜单口径，不替代普通行情或财报。
+
+## 前置条件表
+
+| 条件                                   | 操作                                                                                                  |
+| -------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| 开始任何 CLI 调用                      | 先读取并遵循 [hithink-finance-shared](../hithink-finance-shared/SKILL.md)                             |
+| 不确定命令是否存在或参数是否变化       | 运行 `hithink-finance capabilities --format json`，再运行 `hithink-finance schema <id> --format json` |
+| 需要执行下表某个命令                   | 先读取对应 reference 文件，不要只凭命令名猜参数                                                       |
+| 结果可能是全市场、分页、多标的或长区间 | 使用命令声明的 `--output <path>` 落盘；远端 stdout 只返回摘要                                         |
+
+## 快速决策
+
+| 用户意图                     | 首选命令 / 路由                 |
+| ---------------------------- | ------------------------------- |
+| 今日异动列表/异动标签        | `special anomaly-list`，仅今日  |
+| 最多 50 只股票的今日异动原因 | `special anomaly-stock`，仅今日 |
+| 涨停池分页                   | `special limit-up-pool`         |
+| 连板天梯                     | `special limit-up-ladder`       |
+| 飙升榜                       | `special skyrocket`             |
+| 当前热股榜                   | `special hot-stock`             |
+| 历史热股榜                   | `special hot-stock-history`     |
+| 单股热度趋势                 | `special hot-stock-trend`       |
+| 龙虎榜/机构/游资             | `special dragon-tiger`          |
+
+## Shortcuts
+
+| 命令                                                                 | 何时使用                                                |
+| -------------------------------------------------------------------- | ------------------------------------------------------- |
+| [special anomaly-list](references/special-anomaly-list.md)           | Query today-only anomaly analysis rows                  |
+| [special anomaly-stock](references/special-anomaly-stock.md)         | Query today-only anomalies for up to 50 raw code tokens |
+| [special dragon-tiger](references/special-dragon-tiger.md)           | Query dragon-tiger board records                        |
+| [special hot-stock](references/special-hot-stock.md)                 | Query the current hot-stock ranking                     |
+| [special hot-stock-history](references/special-hot-stock-history.md) | Query a historical hot-stock ranking                    |
+| [special hot-stock-trend](references/special-hot-stock-trend.md)     | Query one stock hot-rank trend                          |
+| [special limit-up-ladder](references/special-limit-up-ladder.md)     | Query the 30-day limit-up ladder                        |
+| [special limit-up-pool](references/special-limit-up-pool.md)         | Query the limit-up stock pool                           |
+| [special skyrocket](references/special-skyrocket.md)                 | Query the skyrocket ranking                             |
+
+## 原生命令与 schema
+
+```bash
+hithink-finance capabilities --format json
+hithink-finance schema <capability-id> --format json
+hithink-finance special <command> --help
+```
+
+使用原生命令前必须先看 schema；schema 是当前 CLI 参数契约，reference 是决策和边界补充。
+
+## 权限表
+
+| 命令类型                       | 要求                                                                   |
+| ------------------------------ | ---------------------------------------------------------------------- |
+| 远端服务查询                   | API Key 来自系统凭据库、`HITHINK_FINANCE_API_KEY` 或 `--api-key-stdin` |
+| 本地 DuckDB 查询/导出          | 本地库存在且 schema 兼容；可用全局 `--db <path>` 指定                  |
+| 删除、迁移、修复等有副作用操作 | 先预览或说明影响；需要用户明确确认时才加 `--yes`                       |
+
+## 边界声明
+
+- today-only 能力不能补历史；用户要历史时说明边界并选择有历史窗口的命令。
+- 榜单热度不是投资建议，不要扩写成推荐或确定性原因。

package/skills/hithink-finance-special-data/references/special-anomaly-list.md

@@ -0,0 +1,36 @@
+# `hithink-finance special anomaly-list`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema special.anomaly-list --format json` 确认当前参数契约。
+- 远端命令需要 API Key；认证失败时回到 shared skill。
+
+## 命令
+
+```bash
+hithink-finance schema special.anomaly-list --format json
+hithink-finance special anomaly-list --format json
+```
+
+## 参数选择策略
+
+| 参数                  | 必填 | 说明                                              |
+| --------------------- | ---- | ------------------------------------------------- |
+| `--tag-codes <codes>` | 否   | comma-separated anomaly tags；上游参数: tag_codes |
+| `--output <path>`     | 否   | write the full JSON response envelope to a file   |
+
+## 窗口与分页
+
+- 仅当前交易日/今日数据；不能补历史。
+- 无分页参数；仍检查返回中的 count/数组长度。
+
+## 常见错误
+
+- 参数校验失败时按 `error.hint` 修正，不要猜字段名。
+- 认证失败时不要重试刷屏；先处理 API Key。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-special-data/references/special-anomaly-stock.md

@@ -0,0 +1,37 @@
+# `hithink-finance special anomaly-stock`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema special.anomaly-stock --format json` 确认当前参数契约。
+- 远端命令需要 API Key；认证失败时回到 shared skill。
+
+## 命令
+
+```bash
+hithink-finance schema special.anomaly-stock --format json
+hithink-finance special anomaly-stock --thscodes <codes> --format json
+hithink-finance special anomaly-stock --codes-file codes.txt --output result.json --format json
+```
+
+## 参数选择策略
+
+| 参数                 | 必填 | 说明                                            |
+| -------------------- | ---- | ----------------------------------------------- |
+| `--thscodes <codes>` | 是   | 1-50 comma-separated A-share thscodes           |
+| `--output <path>`    | 否   | write the full JSON response envelope to a file |
+
+## 窗口与分页
+
+- 仅当前交易日/今日数据；不能补历史。
+- 无分页参数；仍检查返回中的 count/数组长度。
+
+## 常见错误
+
+- 参数校验失败时按 `error.hint` 修正，不要猜字段名。
+- 认证失败时不要重试刷屏；先处理 API Key。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 支持 `--codes-file` 或 `--codes-stdin` 读取多 thscode；不要同时用 `--api-key-stdin` 和 `--codes-stdin`。