Skip to content

docs(knowledge): add 3 active ETF datasets to catalog (fix doc-sync CI) - #15

Merged
linsamtw merged 1 commit into
masterfrom
docs/catalog-activeetf
Jul 17, 2026
Merged

docs(knowledge): add 3 active ETF datasets to catalog (fix doc-sync CI)#15
linsamtw merged 1 commit into
masterfrom
docs/catalog-activeetf

Conversation

@linsamtw

Copy link
Copy Markdown
Contributor

背景

doc-sync CI gate(#12)如期發揮作用:FinMind-Doc 已上線三個主動式 ETF dataset,但 knowledge/datasets.mdlist_datasets 工具與 Custom GPT bundle 的 SSOT)沒跟上,目前所有 PR 的 doc-sync job 都會紅(例如 #14)。

內容

在「台股 - 籌碼面」補三個 dataset(欄位 / tier / 參數對照 FinMind-Doc origin/masterChip.mdllms-full.txt,非憑記憶):

  • TaiwanStockActiveETFInfo(Free)— 主動式ETF清單,無需 data_id
  • TaiwanStockActiveETFHolding(Sponsor)— 每日持股明細,含 shares 整數 / 空方部位可負 / market_value 部分揭露 / asset_type 篩選等判讀註記
  • TaiwanStockActiveETFHoldingChange(Sponsor)— 每日持股異動(差分衍生),buy/sell 整數且每列僅其一非 0

另把首行總數「共約 90 個」更新為「共約 100 個」(實際 101)。

驗證

  • check_doc_sync.py(對 FinMind-Doc origin/master):OK,98 documented / 101 catalog
  • pytest:32 passed
  • build_instructions.py:7987/8000 chars(未超限)

備註

merge 後 #14 會 rebase 重跑 CI 轉綠。catalog 進 wheel(list_datasets 讀它),之後發新版 tag 時使用者端才會拿到;Custom GPT bundle 需重跑 build_instructions.py 重貼。

🤖 Generated with Claude Code

doc-sync CI gate 發現 knowledge/datasets.md 落後 FinMind-Doc:
三個主動式 ETF dataset 已進 Doc 但 catalog 未補,導致所有 PR 的
doc-sync job 紅(如 #14)。

knowledge/datasets.md(台股 - 籌碼面,接在 LoanCollateralBalance 後):
- TaiwanStockActiveETFInfo — Free,主動式ETF清單(上市+上櫃),
  category=domestic/foreign、type=twse/tpex,無需 data_id
- TaiwanStockActiveETFHolding — Sponsor,每日持股明細(2025-05-05~),
  stock_id=ETF、component_stock_id=成份標的;shares 整數、空方部位可負、
  market_value 部分揭露未揭露為 0、asset_type 8 類
- TaiwanStockActiveETFHoldingChange — Sponsor,每日持股異動(差分衍生),
  buy/sell 整數股數每列僅其一非 0、含申贖等比例變動
- 首行 dataset 總數「共約 90 個」→「共約 100 個」(實際 101)

欄位/tier/參數皆對照 FinMind-Doc origin/master(Chip.md + llms-full.txt)。
本地驗證:check_doc_sync.py OK(98 documented / 101 catalog)、
32 pytest passed、build_instructions 7987/8000 chars。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@linsamtw
linsamtw merged commit 7636cb3 into master Jul 17, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant