analyze-japan-debt-service-tax-burden

name	analyze-japan-debt-service-tax-burden
description	以日本公債殖利率變化為觸發，量化「政府利息支出 / 稅收」負擔（含情境壓力測試），並判斷是否進入債務利息螺旋風險區。

分析日本債務利息負擔 Skill

以公開數據量化日本「利息吃掉稅收」的敘事，提供可驗證的現況核對、敏感度分析與風險分級。

<essential_principles>

**核心指標：利息/稅收比**

interest_tax_ratio = interest_payments / tax_revenue

這是影片敘事「利息吃掉 1/3 稅收」的可核驗版本。不同口徑（國稅 vs 一般會計稅收 vs 總收入）會產生不同數值，必須明示口徑選擇。

口徑對照（FY2025）：

口徑	計算	比例
純利息/稅收	10.5兆/70兆	15.0%
國債費/稅收	28.2兆/70兆	40.3%

注意：媒體敘事「利息吃掉 1/3」通常誤用國債費（含本金）口徑。

**隱含平均利率**

implied_avg_rate = interest_payments / debt_stock

衡量存量債務的平均融資成本。對比當前市場利率可評估再融資壓力。

FY2025：10.5兆 / 1,324兆 = 0.79% vs 當前 10Y 殖利率 2.0%+ → 差距反映大量存量債務在低利率時期發行，未來再融資將推高利息負擔。

**「in US terms」換算邏輯**

媒體常用「美國等效規模」表達日本債務以增強震撼效果。

公式（動態計算）：

debt_to_gdp = japan_debt_stock / japan_gdp
debt_in_us_terms = us_gdp × debt_to_gdp

數據來源：GDP 從 FRED 實時抓取，非硬編碼。

範例：$30.6T × 250% = $76.5T ≈ $70T（媒體口語化）

用途：解釋影片/新聞中「$70T」數字的來源，用於跨國比較時統一規模感知。

**殖利率敏感度映射**

把殖利率變動映射到利息支出增加：

additional_interest ≈ debt_stock × pass_through × delta_yield

其中 pass_through 是年度再定價/再融資比例（約 15%），delta_yield 以小數表示（200bp = 0.02）。

**風險分級（Traffic Light）** **口徑透明原則** 量化日本「利息吃掉稅收」敘事，並提供： 1. **現況核對**：當前 interest/tax ratio 與殖利率分位數 2. **壓力測試**：不同利率衝擊情境下的未來負擔 3. **風險分級**：可決策的 Traffic Light 評估 4. **外溢通道**（選用）：日本對美資產規模與潛在影響 您想要執行什麼操作？ | Response | Workflow | Description | |-------------------------------------------|------------------------------|----------------------| | 1, "快速", "quick", "check" | workflows/quick-check.md | 快速狀態檢查 | | 2, "完整", "full", "analyze" | workflows/full-analysis.md | 完整分析工作流 | | 3, "壓測", "stress", "scenario" | workflows/stress-test.md | 情境壓力測試 | | 4, "圖表", "chart", "dashboard" | workflows/generate-chart.md | 生成視覺化圖表 | | 5, "螺旋", "spiral", "多年" | workflows/spiral-simulate.md | 債務螺旋模擬 | | 6, "歷史", "趨勢", "historical", "2015" | workflows/historical-trend.md| 歷史趨勢分析（NEW!） | | 7, "學習", "方法論", "why" | references/methodology.md | 方法論說明 | | 提供參數 (如殖利率衝擊) | workflows/stress-test.md | 使用參數執行壓測 | **Type**: string **Description**: 固定 JP / Japan（預留擴展多國） **Type**: int **Description**: 殖利率與市場指標分析視窗（交易日數） **Type**: array[string] **Description**: JGB 觀察期限 **Type**: string **Options**: `national_tax` | `general_account_tax` | `total_revenue` **Description**: 稅收口徑選擇 **Type**: string **Options**: `interest_only` | `debt_service` **Description**: 利息支出口徑（純利息 vs 含本金償還） **Type**: array[object] **Description**: 壓力測試情境設定 **Type**: boolean **Description**: 是否計算日本對美資產外溢通道 **Type**: string **Options**: `json` | `markdown`