@hithink-tech/hithink-finance-cli 0.1.0

package/skills/hithink-finance-data/references/data-validate.md

@@ -0,0 +1,33 @@
+# `hithink-finance data validate`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema data.validate --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 用于同步、迁移、研究导出前的质量门禁。
+
+## 命令
+
+```bash
+hithink-finance schema data.validate --format json
+hithink-finance data validate --format json
+```
+
+## 参数选择策略
+
+- 可用全局 `--db <path>` 指定库。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 报告数据质量问题时给出 check 名称和 count，不要展开全量行。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-data/references/db-describe.md

@@ -0,0 +1,33 @@
+# `hithink-finance db describe`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema db.describe --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 查询本地 DuckDB 表和视图清单。
+
+## 命令
+
+```bash
+hithink-finance schema db.describe --format json
+hithink-finance db describe --format json
+```
+
+## 参数选择策略
+
+- 可用全局 `--db <path>` 指定库。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 如果库不存在或 schema 不兼容，先处理 `data status|migrate`。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-data/references/db-export.md

@@ -0,0 +1,33 @@
+# `hithink-finance db export`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema db.export --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 用于大结果或下游 pandas/notebook 消费。
+
+## 命令
+
+```bash
+hithink-finance schema db.export --format json
+hithink-finance db export --sql <sql> --output <path> --format json
+```
+
+## 参数选择策略
+
+- 必填 `--sql <sql>` 和 `--output <path>`；`--file-format ndjson|csv|parquet`。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 导出后只汇报路径、格式、行数，不回显文件内容。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

package/skills/hithink-finance-data/references/db-query.md

@@ -0,0 +1,33 @@
+# `hithink-finance db query`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema db.query --format json` 确认当前参数契约。
+- 本地命令通常需要可用 DuckDB 或本地数据目录。
+- 只读 SQL；小结果才可直接读取 JSON。
+
+## 命令
+
+```bash
+hithink-finance schema db.query --format json
+hithink-finance db query --sql <sql> --format json
+```
+
+## 参数选择策略
+
+- 必填 `--sql <sql>`；大结果改用 `db export`。
+
+## 窗口与分页
+
+- 本地命令无远端分页；只有声明 `--output` 的命令可直接落盘；其他大结果改用导出命令。
+
+## 常见错误
+
+- 本地库不存在或 schema 不兼容时先运行 `data status` / `data migrate`。
+- 不要执行写入、DDL、删除、外部函数或会改变状态的 SQL。
+
+## 批量操作说明
+
+- 批量或全量请求必须落盘，最终只报告路径、行数和窗口。
+- 如果需要多标的循环，逐批执行并记录每批参数；不要把完整结果塞进上下文。

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

@@ -0,0 +1,59 @@
+---
+name: hithink-finance-financials
+description: '用于 Agent 通过 hithink-finance CLI 查询 A 股利润表、资产负债表、现金流量表、财务指标、年度/季度报告窗口；价格行情转 hithink-finance-market，指数财务不在本 skill 范围。'
+---
+
+# hithink-finance-financials
+
+A 股财务报表和指标入口。把报告期、时间窗口和 limit 约束转成稳定命令。
+
+## 前置条件表
+
+| 条件                                   | 操作                                                                                                  |
+| -------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| 开始任何 CLI 调用                      | 先读取并遵循 [hithink-finance-shared](../hithink-finance-shared/SKILL.md)                             |
+| 不确定命令是否存在或参数是否变化       | 运行 `hithink-finance capabilities --format json`，再运行 `hithink-finance schema <id> --format json` |
+| 需要执行下表某个命令                   | 先读取对应 reference 文件，不要只凭命令名猜参数                                                       |
+| 结果可能是全市场、分页、多标的或长区间 | 使用命令声明的 `--output <path>` 落盘；远端 stdout 只返回摘要                                         |
+
+## 快速决策
+
+| 用户意图                | 首选命令 / 路由               |
+| ----------------------- | ----------------------------- |
+| 利润表/收入成本利润项目 | `financials income`           |
+| 资产负债结构            | `financials balance-sheet`    |
+| 现金流量项目            | `financials cash-flow`        |
+| 单个报告期的财务指标    | `financials indicators`       |
+| 用户问价格或涨跌        | 切到 `hithink-finance-market` |
+
+## Shortcuts
+
+| 命令                                                               | 何时使用                                 |
+| ------------------------------------------------------------------ | ---------------------------------------- |
+| [financials balance-sheet](references/financials-balance-sheet.md) | Query balance-sheet financial statements |
+| [financials cash-flow](references/financials-cash-flow.md)         | Query cash-flow financial statements     |
+| [financials income](references/financials-income.md)               | Query income financial statements        |
+| [financials indicators](references/financials-indicators.md)       | Query financial indicators for a report  |
+
+## 原生命令与 schema
+
+```bash
+hithink-finance capabilities --format json
+hithink-finance schema <capability-id> --format json
+hithink-finance financials <command> --help
+```
+
+使用原生命令前必须先看 schema；schema 是当前 CLI 参数契约，reference 是决策和边界补充。
+
+## 权限表
+
+| 命令类型                       | 要求                                                                   |
+| ------------------------------ | ---------------------------------------------------------------------- |
+| 远端服务查询                   | API Key 来自系统凭据库、`HITHINK_FINANCE_API_KEY` 或 `--api-key-stdin` |
+| 本地 DuckDB 查询/导出          | 本地库存在且 schema 兼容；可用全局 `--db <path>` 指定                  |
+| 删除、迁移、修复等有副作用操作 | 先预览或说明影响；需要用户明确确认时才加 `--yes`                       |
+
+## 边界声明
+
+- 财务报表窗口最多 10 年；超过时拆分不重叠窗口并合并去重。
+- `--limit` 与 `--start-ms/--end-ms` 互斥；不要同时传。

package/skills/hithink-finance-financials/references/financials-balance-sheet.md

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

package/skills/hithink-finance-financials/references/financials-cash-flow.md

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

package/skills/hithink-finance-financials/references/financials-income.md

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

package/skills/hithink-finance-financials/references/financials-indicators.md

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

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

@@ -0,0 +1,59 @@
+---
+name: hithink-finance-index
+description: '用于 Agent 通过 hithink-finance CLI 查询同花顺指数/概念/行业/地域/特色指数目录、指数成分股、指数快照和指数历史；个股行情转 hithink-finance-market，股票代码搜索转 hithink-finance-symbol。'
+---
+
+# hithink-finance-index
+
+指数目录、指数成分和指数行情入口。只处理指数对象及其成分关系。
+
+## 前置条件表
+
+| 条件                                   | 操作                                                                                                  |
+| -------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| 开始任何 CLI 调用                      | 先读取并遵循 [hithink-finance-shared](../hithink-finance-shared/SKILL.md)                             |
+| 不确定命令是否存在或参数是否变化       | 运行 `hithink-finance capabilities --format json`，再运行 `hithink-finance schema <id> --format json` |
+| 需要执行下表某个命令                   | 先读取对应 reference 文件，不要只凭命令名猜参数                                                       |
+| 结果可能是全市场、分页、多标的或长区间 | 使用命令声明的 `--output <path>` 落盘；远端 stdout 只返回摘要                                         |
+
+## 快速决策
+
+| 用户意图                      | 首选命令 / 路由               |
+| ----------------------------- | ----------------------------- |
+| 找概念/行业/地域/特色指数目录 | `index catalog`               |
+| 查某个指数成分股              | `index constituents`          |
+| 查指数实时快照                | `index snapshot`              |
+| 查指数历史日线                | `index history`               |
+| 查个股历史/快照               | 切到 `hithink-finance-market` |
+
+## Shortcuts
+
+| 命令                                                   | 何时使用                     |
+| ------------------------------------------------------ | ---------------------------- |
+| [index catalog](references/index-catalog.md)           | List THS indices by category |
+| [index constituents](references/index-constituents.md) | Query index constituents     |
+| [index history](references/index-history.md)           | Query daily index history    |
+| [index snapshot](references/index-snapshot.md)         | Query index price snapshots  |
+
+## 原生命令与 schema
+
+```bash
+hithink-finance capabilities --format json
+hithink-finance schema <capability-id> --format json
+hithink-finance index <command> --help
+```
+
+使用原生命令前必须先看 schema；schema 是当前 CLI 参数契约，reference 是决策和边界补充。
+
+## 权限表
+
+| 命令类型                       | 要求                                                                   |
+| ------------------------------ | ---------------------------------------------------------------------- |
+| 远端服务查询                   | API Key 来自系统凭据库、`HITHINK_FINANCE_API_KEY` 或 `--api-key-stdin` |
+| 本地 DuckDB 查询/导出          | 本地库存在且 schema 兼容；可用全局 `--db <path>` 指定                  |
+| 删除、迁移、修复等有副作用操作 | 先预览或说明影响；需要用户明确确认时才加 `--yes`                       |
+
+## 边界声明
+
+- 指数代码通常是 `000000.SH/SZ/BJ/TI` 形式；不要把 A 股股票 thscode 当指数代码。
+- 成分股结果是指数成员关系，不等于用户的投资组合或推荐清单。

package/skills/hithink-finance-index/references/index-catalog.md

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

package/skills/hithink-finance-index/references/index-constituents.md

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

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

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

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

@@ -0,0 +1,37 @@
+# `hithink-finance index snapshot`
+
+## 前置条件
+
+- 先读取本 skill 的 `SKILL.md` 和 `../hithink-finance-shared/SKILL.md`。
+- 执行前用 `hithink-finance schema index.snapshot --format json` 确认当前参数契约。
+- 远端命令需要 API Key；认证失败时回到 shared skill。
+
+## 命令
+
+```bash
+hithink-finance schema index.snapshot --format json
+hithink-finance index snapshot --thscodes <codes> --format json
+hithink-finance index snapshot --codes-file codes.txt --output result.json --format json
+```
+
+## 参数选择策略
+
+| 参数                 | 必填 | 说明                                            |
+| -------------------- | ---- | ----------------------------------------------- |
+| `--thscodes <codes>` | 是   | comma-separated index 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`。

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

@@ -0,0 +1,63 @@
+---
+name: hithink-finance-market
+description: '用于 Agent 通过 hithink-finance CLI 获取普通 A 股行情快照、历史 K 线、交易日历、复权因子、公司行动、本地全市场面板；涨停、热榜、龙虎榜、异动和游资机构榜转 hithink-finance-special-data。'
+---
+
+# hithink-finance-market
+
+普通行情和本地行情派生能力。优先使用本地库覆盖的历史/面板能力，必要时走远端同花顺金融数据服务。
+
+## 前置条件表
+
+| 条件                                   | 操作                                                                                                  |
+| -------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| 开始任何 CLI 调用                      | 先读取并遵循 [hithink-finance-shared](../hithink-finance-shared/SKILL.md)                             |
+| 不确定命令是否存在或参数是否变化       | 运行 `hithink-finance capabilities --format json`，再运行 `hithink-finance schema <id> --format json` |
+| 需要执行下表某个命令                   | 先读取对应 reference 文件，不要只凭命令名猜参数                                                       |
+| 结果可能是全市场、分页、多标的或长区间 | 使用命令声明的 `--output <path>` 落盘；远端 stdout 只返回摘要                                         |
+
+## 快速决策
+
+| 用户意图                         | 首选命令 / 路由                                        |
+| -------------------------------- | ------------------------------------------------------ |
+| 单票历史日线/K 线                | `market history`；`--source auto` 会在本地覆盖时走本地 |
+| 实时或分页行情快照               | `market snapshot`                                      |
+| 交易日历                         | `market calendar`                                      |
+| 复权因子                         | `market adjustment-factors`                            |
+| 公司行动/除权除息事件            | `market corporate-actions`                             |
+| 全市场区间面板/批量研究输入      | `market panel --output <file>`                         |
+| 涨停池、连板、热股、龙虎榜、异动 | 切到 `hithink-finance-special-data`                    |
+
+## Shortcuts
+
+| 命令                                                                 | 何时使用                                       |
+| -------------------------------------------------------------------- | ---------------------------------------------- |
+| [market adjustment-factors](references/market-adjustment-factors.md) | 查询本地日级复权因子；需要本地库。             |
+| [market calendar](references/market-calendar.md)                     | Query the one-year A-share trading calendar    |
+| [market corporate-actions](references/market-corporate-actions.md)   | Query adjustment events                        |
+| [market history](references/market-history.md)                       | Query daily A-share history                    |
+| [market panel](references/market-panel.md)                           | 需要本地库覆盖请求窗口；适合作为研究样本输入。 |
+| [market snapshot](references/market-snapshot.md)                     | Query A-share price snapshots                  |
+
+## 原生命令与 schema
+
+```bash
+hithink-finance capabilities --format json
+hithink-finance schema <capability-id> --format json
+hithink-finance market <command> --help
+```
+
+使用原生命令前必须先看 schema；schema 是当前 CLI 参数契约，reference 是决策和边界补充。
+
+## 权限表
+
+| 命令类型                       | 要求                                                                   |
+| ------------------------------ | ---------------------------------------------------------------------- |
+| 远端服务查询                   | API Key 来自系统凭据库、`HITHINK_FINANCE_API_KEY` 或 `--api-key-stdin` |
+| 本地 DuckDB 查询/导出          | 本地库存在且 schema 兼容；可用全局 `--db <path>` 指定                  |
+| 删除、迁移、修复等有副作用操作 | 先预览或说明影响；需要用户明确确认时才加 `--yes`                       |
+
+## 边界声明
+
+- 不提供投资建议、买卖判断或收益承诺；只返回数据或中立统计。
+- 全市场、长区间、多标的结果必须落盘，只汇报路径、行数和关键元信息。