analyze-jgb-insurer-superlong-flow

name	analyze-jgb-insurer-superlong-flow
description	從日本保險公司對超長期（10年以上）JGB 的淨買賣時間序列，自動產出「本月是否創紀錄淨賣出、連續淨賣出月數、期間累積淨賣出」等結論。

分析日本保險公司超長期 JGB 淨買賣流量 Skill

以 JSDA 公開數據驗證「保險公司創紀錄賣超長端國債」等敘事，提供可複製的摘要（含 streak / record / 累積值）。

<essential_principles>

**核心數據來源：JSDA 公社債店頭売買高（Trading Volume of OTC Bonds）**

日本證券業協會（JSDA）自 2018/05 起將投資人別交易統計整併進「Trading Volume of OTC Bonds」資料集。

數據位置：

• 當前財年：https://www.jsda.or.jp/shiryoshitsu/toukei/tentoubaibai/koushasai.xlsx
• 歷史財年：https://www.jsda.or.jp/shiryoshitsu/toukei/tentoubaibai/koushasai{YYYY}.xlsx

關鍵 Sheet：

• (Ｊ)合計差引 - 淨買賣額（Sell - Purchase）

數據特徵：

• 頻率：月度
• 分類：投資人類型 × 債券類型 × 天期桶
• 單位：億日圓（100 million yen）
• 延遲：約 T+1 個月

注意：2018/05 前的舊版「Trends in Bond Transactions (by investor type)」已停止更新。

**符號慣例（重要！）**

JSDA 使用「賣出 - 買入」作為差引計算方式：

net_sale = 賣出金額 - 買入金額

• 正值 = 淨賣出（賣出 > 買入，需求減少）
• 負值 = 淨買入（買入 > 賣出，需求增加）

這與部分新聞報導的符號相反，需特別注意。

**天期桶口徑對齊**

JSDA Excel 欄位結構（第 4 列）：

JSDA 欄位	英文	說明
超長期	Interest-bearing Long-term (over 10-year)	10 年以上利付債
利付長期	Interest-bearing Long-term	5-10 年利付債
利付中期	Interest-bearing Medium-term

**投資人分類** **歷史極值判斷邏輯** 驗證「日本保險公司創紀錄賣超長端 JGB」等敘事，並提供： 1. **本月淨賣出/買入**：最新月份數值（億日圓） 2. **是否創紀錄**：判斷是否為樣本最大淨賣出（正值最大） 3. **連續淨賣出月數**：streak_len 4. **本輪累積淨賣出**：cum_over_streak 5. **Z-score 與分位數**：相對歷史的極端程度 您想要執行什麼操作？ | Response | Action | |---------------------------------|-------------------------------------| | 1, "快速", "quick", "check" | `python scripts/jsda_flow_analyzer.py --quick` | | 2, "完整", "full", "analyze" | `python scripts/jsda_flow_analyzer.py --full` | | 3, "驗證", "verify", "新聞" | 讀取 workflows/verify-claim.md | | 4, "json", "JSON" | `python scripts/jsda_flow_analyzer.py --format json` | **Type**: flag **Description**: 快速檢查模式（使用快取數據） **Type**: flag **Description**: 完整分析模式 **Type**: int **Description**: 起始財年（日本財年 4 月開始） **Type**: int **Description**: 回溯月數（預設全樣本） **Type**: string **Options**: `json` | `markdown` **Description**: 輸出格式 **Type**: flag **Description**: 強制重新下載數據 **Type**: string **Description**: 輸出檔案路徑