Skip to content

Commit c8855e1

Browse files
linsamtwclaude
andcommitted
feat(plugin): bundle a finmind skill alongside the MCP server
讓 `/plugin install finmind-mcp@finmind-official` 一次同時給使用者 MCP tools **和** 一個 skill。Claude Code 會自動從 plugin root 的 skills/ 探索 skill (namespaced 為 /finmind-mcp:finmind),不需 plugin.json 宣告。 skills/finmind/SKILL.md:驅動同 plugin 內的 finmind MCP tools —— 意圖→dataset 對照、日期規則、公司名↔代號、多步驟、輸出/畫圖指引。內嵌 canonical 修正(台指期 data_id=TX 非 TXF;InterestRate 必填 data_id 如 FED)。內容改編自已上線的 /finmind skill + knowledge/instructions.md。 已用 subagent application test 驗過:5 個查詢的 tool/dataset/params 都正確,含 TX/FED 兩個雷與「不確定先 list_datasets」路徑。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent f0aeca0 commit c8855e1

1 file changed

Lines changed: 56 additions & 0 deletions

File tree

skills/finmind/SKILL.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
---
2+
name: finmind
3+
description: Use when the user asks about Taiwan or global financial data — 股價/開高低收, 月營收, 三大法人買賣超, 融資融券, 股利/配息, 本益比 PER, 期貨/選擇權, 匯率, 央行利率, 美股 — or to resolve a Taiwan stock 名稱↔代號. Pairs with the bundled FinMind MCP server.
4+
---
5+
6+
# FinMind 金融資料助手
7+
8+
用本 plugin 內含的 **`finmind` MCP server tools** 回答台股/全球金融資料問題,
9+
**不要自己組 HTTP 請求**。可用 tools:
10+
11+
- `query_dataset` — 通用查詢(`dataset` + `data_id` + `start_date`/`end_date`
12+
- `get_stock_info` — 台股代號/中文名/產業查詢(TaiwanStockInfo)
13+
- `list_datasets` — 列出所有可用 dataset;不確定用哪個時先查
14+
- `query_trading_daily_report` — 券商分點進出(Sponsor 等級,必填 `data_id` + 單日 `date`
15+
16+
需要 `FINMIND_TOKEN`(會員中心 <https://finmindtrade.com/analysis/#/account/user> 取得)。
17+
未設定或 401 時,引導使用者去該頁取得 Token 並設成環境變數。
18+
19+
## 流程
20+
21+
1. 解析意圖 → 對到 dataset(見下表);不確定就先呼叫 `list_datasets`
22+
2. 使用者給公司名而非代號 → 先 `get_stock_info` 轉成代號。
23+
3. 日期規則:「最近一週」= 今天−7 天含當日;「今年」= 當年 1/1 至今日;沒指定預設近三個月。
24+
4. 呼叫 `query_dataset`,結果整理成 markdown 表格;時間序列/比較再加圖。
25+
5. 多步驟問題(比較多檔、篩選)連續呼叫、合併後再分析。
26+
27+
## 常見意圖 → dataset
28+
29+
| 意圖 | dataset |
30+
|---|---|
31+
| 股價、開高低收、成交量 | `TaiwanStockPrice` |
32+
| 還原股價(除權息調整)| `TaiwanStockPriceAdj` |
33+
| 本益比 / 股價淨值比 | `TaiwanStockPER` |
34+
| 月營收 | `TaiwanStockMonthRevenue` |
35+
| 損益表 / EPS / 財報 | `TaiwanStockFinancialStatements` |
36+
| 股利 / 配息 | `TaiwanStockDividend` |
37+
| 三大法人買賣超 | `TaiwanStockInstitutionalInvestorsBuySell` |
38+
| 融資融券 | `TaiwanStockMarginPurchaseShortSale` |
39+
| 外資持股比例 | `TaiwanStockShareholding` |
40+
| 期貨日成交 | `TaiwanFuturesDaily`(台指期 `data_id=TX`**不是 TXF**|
41+
| 選擇權日成交 | `TaiwanOptionDaily` |
42+
| 匯率 | `TaiwanExchangeRate`(美元 `data_id=USD`|
43+
| 央行利率 | `InterestRate`**必填 `data_id`**,美國=`FED`、歐洲=`ECB`、日本=`BOJ`|
44+
| 美股股價 | `USStockPrice` |
45+
| 查股票代號 / 中文名 | `get_stock_info`(或 `TaiwanStockInfo`|
46+
47+
常用代號:2330 台積電、2317 鴻海、2454 聯發科、2882 國泰金、0050 元大台灣50。
48+
完整 dataset 清單與欄位細節:用 `list_datasets`,或讀 MCP resource(knowledge `datasets.md`)。
49+
50+
## 畫圖
51+
52+
時間序列 / 比較 / 分布適合配圖。圖表的 **title、軸標籤、圖例一律用英文**,避免中文字型缺字。
53+
54+
## 不做
55+
56+
個人化投資建議、預測未來價格 — 只提供資料與客觀整理。

0 commit comments

Comments
 (0)