AgentSkillsCN

taiwan-railway

查詢台灣鐵路 (台鐵 TRA) 與台灣高鐵 (THSR) 的即時時刻表。當使用者需要查詢火車班次、出發/抵達時間或車次資訊時使用。支援透過 TDX API 獲取官方最準確資料。

中文原作
SKILL.md
--- frontmatter
name: taiwan-railway
description: 查詢台灣鐵路 (台鐵 TRA) 與台灣高鐵 (THSR) 的即時時刻表。當使用者需要查詢火車班次、出發/抵達時間或車次資訊時使用。支援透過 TDX API 獲取官方最準確資料。

Taiwan Railway Skill

本技能提供台鐵與高鐵的即時時刻表查詢功能，並具備車站代碼本地快取機制（30 天自動更新）。

核心原則

  • •官方 API 優先： 絕不輕信第三方網站，必須透過 TDX API 獲取資料。
  • •快取機制： 為節省 API 額度，車站代碼儲存於本地 JSON 檔。若檔案超過 30 天未更新，則自動從 API 獲取最新資料。

查詢工作流

1. 獲取車站代碼 (本地快取查詢)

使用腳本檢索代碼。腳本會自動判斷是否需要更新 JSON 檔。

bash
python3 scripts/manage_stations.py {TRA|THSR} {車站名稱}

範例：python3 scripts/manage_stations.py TRA 汐科 -> 輸出 {"id": "0970", "name": "汐科"}

2. 執行時刻表 API 查詢

台鐵 (TRA)

bash
curl 'https://tdx.transportdata.tw/api/basic/v3/Rail/TRA/DailyTrainTimetable/OD/{起站代碼}/to/{迄站代碼}/{YYYY-MM-DD}?%24top=1000&%24format=JSON' \
-H 'User-Agent: Mozilla/5.0...'

高鐵 (THSR)

bash
curl 'https://tdx.transportdata.tw/api/basic/v2/Rail/THSR/DailyTimetable/OD/{起站代碼}/to/{迄站代碼}/{YYYY-MM-DD}' \
-H 'User-Agent: Mozilla/5.0...'

3. 解析與回覆

  • •以簡潔、好讀的列表形式回覆。
  • •提醒使用者提早出門或注意車站長度。

參考資料與快取

  • •車站代碼快取路徑：assets/TRA_stations.json 與 assets/THSR_stations.json
  • •常用手冊：references/stations.md