| name | analyze-platinum-to-brazil-equities-transmission |
| description | 使用公開市場資料量化驗證鉑/白金對巴西股市（EWZ）的長週期傳導/連動關係，輸出雙軸圖、領先落後分析、關聯強度分數與監控訊號。 |
<essential_principles>
**傳導驗證而非預測**
本技能專注於「用數據驗證敘事」：
- 輸入：社群/新聞宣稱「白金走勢可能領先或驅動巴西股市」
- 輸出：長週期時間序列上的傳導假說檢驗結果
不做價格預測，只回答：「白金→巴西股市的傳導結構在數據上是否存在？」
**交叉相關判斷領先落後**
使用 Cross-Correlation 掃描 [-lead_lag_max, +lead_lag_max] 範圍：
corr(r_ewz, r_platinum.shift(lag))- lag > 0：白金領先 EWZ（platinum leads）
- lag < 0：EWZ 領先白金
- lag ≈ 0：同步移動
典型設定：週頻 lag max = 52（一年），找 |corr| 最大的 lag。
**Regime-Dependent 關聯**
白金與巴西股市的關聯具有週期性特徵：
- linked_upcycle：兩者趨勢同向上行，傳導結構穩固
- decoupled：關聯斷裂，各走各的
- brazil_idiosyncratic：巴西特有風險（政治/匯率/商品結構）主導
長期 regime 判斷使用 regime_window（預設 104 週 ≈ 2 年）內的趨勢一致性。
**傳導強度分數（0–100）**
綜合三個維度量化傳導可信度：
| 維度 | 權重 | 說明 |
|---|
| best_lead_lag_corr | 30% | 最佳領先落後相關係數 |
| rolling_corr_stability | 30% | rolling corr > 0 的佔比與連續性 |
| trend_agreement | 40% | 長期趨勢一致程度 |
分數解讀：≥70 強傳導、50-69 中等、<50 弱/不穩定。
**資料來源**
主要使用 Yahoo Finance（免費、無需 API key）：
頻率建議：1wk（週頻）用於長週期分析，避免日頻噪音干擾。
對齊方式：inner join（只保留共同交易日），避免補值造成假相關。
</essential_principles>
量化驗證「白金（Platinum）→ 巴西股市（EWZ）」的長週期傳導關係：
需要進行什麼分析？
| Response | Action |
|------------------------------|----------------------------------------------|
| 1, "快速", "quick", "check" | 閱讀 `workflows/analyze.md` 並以預設參數執行 |
| 2, "完整", "full", "analyze" | 閱讀 `workflows/analyze.md` 並執行 |
| 3, "視覺化", "chart", "plot" | 閱讀 `workflows/visualize.md` 並執行 |
| 4, "學習", "方法論", "why" | 閱讀 `references/methodology.md` |
| 提供參數 (如日期/ticker) | 閱讀 `workflows/analyze.md` 並使用參數執行 |
**Type**: string (ISO YYYY-MM-DD)
**Description**: 分析起始日期
**Example**: "2003-01-01"
**Note**: EWZ 上市於 2000 年 7 月，建議不早於 2000-07-01
**Type**: string (ISO YYYY-MM-DD)
**Description**: 分析結束日期（預設今日）
**Example**: "2026-01-28"
**Type**: string
**Default**: "1wk"
**Options**: "1d" / "1wk" / "1mo"
**Description**: 資料頻率。建議 1wk 或 1mo 用於長週期分析
**Type**: string
**Default**: "PL=F"
**Description**: 白金價格 ticker
**Type**: string
**Default**: "EWZ"
**Description**: 巴西股市 proxy ticker
**Type**: number
**Default**: 100
**Description**: 正規化基準
**Type**: int
**Default**: 52
**Description**: Rolling correlation 視窗（以 frequency 單位）
**Type**: int
**Default**: 52
**Description**: 領先/落後最大掃描期數
**Type**: int
**Default**: 104
**Description**: 長期 regime 判斷窗口
**Type**: string
**Default**: "both"
**Options**: "markdown" / "json" / "both"
