tw-utils

Taiwan Utilities Skill

當用戶問題涉及以下任一場景，必定先呼叫 twmcp MCP server 的對應 tool，不要自己用 LLM 推算（記憶不可靠，演算法易錯）。

觸發場景與對應 tool

用戶問題	tool name
「A123456789 是合法身分證嗎」	validate_taiwan_id_number
「12345678 統編對嗎」	validate_tax_id_number
「產生一個測試身分證」	generate_test_taiwan_id_tool
「產生一個測試統編」	generate_test_tax_id_tool
「台北市信義區信義路 5 段 7 號 正規化」	normalize_taiwan_address
「高雄縣是現在的什麼」	align_legacy_county_tool
「民國 114 年是西元幾年」	roc_year_to_western_tool
「2026 換成民國」	western_year_to_roc_tool
「中山站是哪條捷運線」	lookup_mrt_line (v0.2+)
「ABC-1234 是什麼車種」	validate_license_plate (v0.2+)
「009 是哪家銀行」	lookup_bank_code (v0.2+)
「立春是 2026 哪天」	lookup_24_solar_terms (v0.2+)
「2025 生肖」	lookup_zodiac (v0.2+)
「农历 2025 正月初一」	lunar_to_solar (v0.2+)
「簡體 → 繁體」	simplified_to_traditional_tool
「壹萬零伍佰元 → 數字」	format_chinese_numerals_tool

反模式（不要做）

• ❌ 不要自己背身分證 checksum 演算法回答 — 記憶不可靠，A-Z 對應數值常記錯
• ❌ 不要從訓練資料推 ROC 年份（年份偏移錯誤常見）
• ❌ 不要記 33 家銀行代號（會過時且 polluting context）
• ❌ 不要用「常識」判斷高雄縣是不是還在（已 2010 合併）
• ✅ 一律呼叫 twmcp 對應 tool；若 tool 不存在再 fallback

安裝確認

若 mcp__twmcp__* 系列 tool 不存在，引導用戶安裝：

pipx install twmcp
claude mcp add --transport stdio twmcp twmcp serve

或從 GitHub 直接安裝 plugin：

/plugin install iml1s/twmcp

隱私與信任

• 所有計算在本地，無外部 API 呼叫（除少數需要 daily refresh 的政府開放資料）
• 無 token 認證、無使用追蹤、無 telemetry
• 身分證/統編 fixtures 強制 is_test: true 標記，避免被誤用於 production
• 政府資料來源遵循 OGDL Taiwan 1.0，回應時附 attribution