台灣日常生活查詢的 AI 代理技能組合（寶島 = 台灣的美稱）。 只使用官方 API 與公開資料:財政部電子發票整合服務平台、臺北市資料大平臺、新北市資料開放平臺、台中市政府資料開放平臺、桃園市政府資料開放平臺、YouBike 微笑單車公開資料與官方地圖即時 feed、Open-Meteo、中央氣象署開放資料平臺、國家災害防救科技中心（NCDR CAP）。以不需要登入、不需要 API 金鑰就能安全使用的查詢型技能為核心;少數技能（cwa-weather）使用免費、即時發給的 API 金鑰。
Claude Code、Codex、OpenCode 等支援 npx skills add 的編碼代理（coding agent）都可以使用。
安裝
# 安裝全部技能
npx --yes skills add tahodev/baodao-skill --all -g
# 只安裝特定技能
npx --yes skills add tahodev/baodao-skill --skill invoice-winning-numbers -g
需要 Node.js 18 以上與 npx。詳見安裝指南。
功能
「登入」欄只表示使用者本人是否需要帳號或密鑰。
| 功能 | 技能名 | 說明 | 登入 | 文件 |
|---|---|---|---|---|
| 統一發票對獎 | invoice-winning-numbers | 最新中獎號碼對獎、批次對獎、雲端發票專屬獎（PDF 清單）、歷史期別指引 | 不需要 | invoice-winning-numbers 指南 |
| YouBike 站點即時查詢 | youbike-realtime | 全台 14 個服務區（雙北、桃園、台中、台南、高雄等）YouBike 2.0 站點的可借車輛、可還空位即時數量,含電輔車篩選 | 不需要 | youbike-realtime 指南 |
| 台北/新北垃圾車路線 | taiwan-garbage | 台北市（CSV）+新北市（JSON API）的垃圾清運點與停靠時間;新北含星期排程,可判斷今天有沒有收 | 不需要 | taiwan-garbage 指南 |
| 中央氣象署天氣預報 | cwa-weather | 用 CWA 開放資料 API 查各縣市 36 小時與鄉鎮預報（官方資料） | 需要（免費即時發給） | cwa-weather 指南 |
| 台灣天氣查詢 | taiwan-weather | 用 Open-Meteo（免金鑰）查天氣,並用 NCDR CAP feed（免金鑰）查颱風/地震/海嘯等災害警報（cwa-weather 的免金鑰備援） | 不需要 | taiwan-weather 指南 |
各技能的正本是 <技能名>/SKILL.md。docs/features/ 的指南是摘要版，詳細步驟、參數與錯誤處理請務必參考 SKILL.md。
範圍說明:
- 防爬蟲嚴格的服務（蝦皮、momo、591、foodpanda 等）不在範圍內。
- 不改變外部狀態:不預約、不購買、不發文，只有查詢與計算。
- 資料是各官方來源公告的原始內容。重要判斷（領獎期限、停收日、颱風警報等）請務必回到官方網站確認。
30 天計畫
這個倉庫以「一天一技能」的速度成長中。以下是候選技能，順序未定，完成後會打勾:
- 國定假日與連假查詢（行政院人事行政總處辦公日曆表）
- 中央氣象署天氣預報（免費 API 金鑰）→
cwa-weather - 雲端發票專屬獎中獎號碼 →
invoice-winning-numbers（PDF 清單解析,2026-09-09） - 其他縣市垃圾車（新北 →
taiwan-garbage已支援;桃園、台中、台南、高雄待支援） - 高鐵時刻表與票價（TDX，免費 API 金鑰）
- 台鐵時刻表（TDX，免費 API 金鑰）
- 公車動態查詢（TDX）
- 空氣品質指標 AQI
- 地震速報與颱風動態 →
taiwan-weather的 NCDR CAP 段（2026-09-09） - 停車場剩餘車位
- 郵遞區號查詢
- 台電電力供需資訊
- 油價查詢（台灣中油）
- 匯率查詢
- 停班停課公告
- 農產品交易行情
- 綜合所得稅試算
- 統一編號與身分證字號檢核
- 醫院診所查詢
- 公共圖書館館藏查詢
- 國道即時路況
- 紫外線指數
- 停水公告
- 節氣與農曆換算
- 勞健保費率計算
- 郵資計算
English
baodao-skill (寶島, "baodao" = treasure island, an affectionate name for Taiwan) is a collection of AI-agent skills for daily life in Taiwan. It focuses on read-only lookups built only on official APIs and public datasets: no login walls, no API keys, no scraping.
Works with any coding agent that supports npx skills add (Claude Code, Codex, OpenCode, ...).
Install
# Install every skill
npx --yes skills add tahodev/baodao-skill --all -g
# Install a single skill
npx --yes skills add tahodev/baodao-skill --skill invoice-winning-numbers -g
Node.js 18+ and npx are required. See the install guide for details.
What you can do
| What you can do | Skill | Description | Login | Docs |
|---|---|---|---|---|
| Check Taiwan uniform-invoice winning numbers | invoice-winning-numbers | Latest winning numbers, batch matching, cloud-invoice exclusive prizes (PDF lists), and history pointers from the Ministry of Finance's public pages | Not required | invoice-winning-numbers guide |
| Look up YouBike station availability | youbike-realtime | Real-time rentable bikes and return docks for YouBike 2.0 stations across 14 service areas nationwide (Taipei, New Taipei, Taoyuan, Taichung, Tainan, Kaohsiung, and more), incl. e-bike filtering | Not required | youbike-realtime guide |
| Look up garbage truck routes | taiwan-garbage | Collection stops and times for Taipei (CSV) and New Taipei (JSON API with weekday schedules) | Not required | taiwan-garbage guide |
| Look up official CWA forecasts | cwa-weather | 36-hour county and township forecasts from the CWA open-data API (official source) | Free instant API key | cwa-weather guide |
| Look up weather in Taiwan | taiwan-weather | Keyless Open-Meteo weather plus keyless disaster alerts (typhoon, earthquake, tsunami) via the NCDR CAP feeds (fallback for cwa-weather) | Not required | taiwan-weather guide |
The canonical source for each skill is its <skill>/SKILL.md. The guides under docs/features/ are summaries only - always refer to SKILL.md for full procedures, parameters, and error handling.
Scope notes:
- Services with heavy anti-scraping are out of scope.
- Nothing here changes state: no reservations, purchases, or posts. Lookups and calculations only.
- Data is quoted as-is from official sources. Confirm anything important (claim deadlines, collection holidays, typhoon warnings) on the official site.
This repo grows one skill per day - see the roadmap above.