Macro-skills analyze-copper-supply-concentration-risk

Name: analyze-copper-supply-concentration-risk
Author: fatfingererr

前端展示專用（元資料從 manifest.json 讀取）

install

source · Clone the upstream repo

git clone https://github.com/fatfingererr/macro-skills

manifest: skills/analyze-copper-supply-concentration-risk/skill.yaml

source content

前端展示專用（元資料從 manifest.json 讀取）

displayName: 分析銅供應集中度風險 emoji: "🔶" authorUrl: https://github.com/fatfingererr/macro-skills

tools:

claude-code

featured: false installCount: 0

testQuestions:

question: '分析 1970 至今全球銅供應的國家集中度' imagePath: images/copper-concentration-2026-01-26.png expectedResult: | 🔬 全球銅供應國家集中度分析報告 (1970-2023)

📊 執行摘要 ┌──────────┬─────────┬──────────┬──────────┬────────────┐ │ 指標 │ 1970 │ 2000 │ 2023 │ 變化方向 │ ├──────────┼─────────┼──────────┼──────────┼────────────┤ │ HHI 指數 │ 3,827 │ 3,454 │ 2,452 │ ↓ 下降 36% │ ├──────────┼─────────┼──────────┼──────────┼────────────┤ │ CR4 │ 44.7% │ 54.1% │ 56.2% │ ↑ 上升 │ ├──────────┼─────────┼──────────┼──────────┼────────────┤ │ 智利份額 │ 10.8% │ 34.8% │ 23.5% │ 先升後降 │ ├──────────┼─────────┼──────────┼──────────┼────────────┤ │ 全球產量 │ 6.35 Mt │ 13.22 Mt │ 22.36 Mt │ ↑ 3.5x │ └──────────┴─────────┴──────────┴──────────┴────────────┘

市場結構判讀: 當前 HHI 2,452，處於中等集中邊界（閾值 2,500），供應來源比 1970 年代更加分散。

📈 三大結構性發現
1. HHI 呈現長期下降趨勢
- 1970-1973: 峰值 4,202（高集中）→ 美國主導時期
- 1995-2005: 智利崛起，HHI 維持 3,200-3,500
- 2010-2023: 持續下降至 2,452 → 供應多元化
1. 智利「倒 U 型」軌跡
- 起點 (1970): 10.8% 份額
- 峰值 (2004): 37.2% 份額 ← 全球最高
- 當前 (2023): 23.5% 份額 → 峰值回撤 13.7pp
- 結論: 智利結構性份額下降，但仍為最大單一供應國
1. 新興替代國快速崛起 ┌───────────┬───────────┬───────────┬─────────┐ │ 國家 │ 1970 份額 │ 2023 份額 │ 變化 │ ├───────────┼───────────┼───────────┼─────────┤ │ 秘魯 │ 3.2% │ 12.3% │ +9.1pp │ ├───────────┼───────────┼───────────┼─────────┤ │ 剛果(DRC) │ 6.1% │ 12.9% │ +6.8pp │ ├───────────┼───────────┼───────────┼─────────┤ │ 秘魯+DRC │ 9.3% │ 25.2% │ +15.9pp │ └───────────┴───────────┴───────────┴─────────┘
關鍵轉折: 2023 年秘魯+DRC 合計份額 (25.2%) 首次超越智利 (23.5%)

🎯 供應風險評估

┌────────────┬───────────┬───────────────────────────────┐ │ 風險維度 │ 評估 │ 說明 │ ├────────────┼───────────┼───────────────────────────────┤ │ 國家集中度 │ ⚠️ 中等 │ HHI 2,452 接近中等/低集中邊界 │ ├────────────┼───────────┼───────────────────────────────┤ │ 智利依賴 │ ✅ 下降中 │ 份額從峰值 37% 降至 24% │ ├────────────┼───────────┼───────────────────────────────┤ │ 替代充足度 │ ✅ 良好 │ 秘魯+DRC 已超越智利 │ ├────────────┼───────────┼───────────────────────────────┤ │ 地緣分散 │ ⚠️ 關注 │ 秘魯/DRC 政治風險較高 │ └────────────┴───────────┴───────────────────────────────┘

📉 視覺化分析

圖表已保存至: output/copper_concentration_1970-2023.png

四個子圖分別顯示:
1. HHI 時序趨勢 - 長期下降，目前接近 2,500 閾值
2. CR4 演變 - 前四國份額穩定在 55-60%
3. 國家份額堆疊圖 - 智利紅色區塊明顯收窄，DRC/秘魯擴張
4. 智利 vs 替代國 - 2023 年出現份額逆轉
💡 結論
1. 市場結構改善: 從 1970 年代的高集中逐步轉向中低集中
2. 智利峰值已過: 2004 年觸頂後持續回落，結構性下降
3. 供應多元化: 秘魯和 DRC 成為關鍵替代來源
4. 監測重點: 關注秘魯/DRC 政治穩定性與投資環境
question: '智利銅產量是否出現結構性衰退？' imagePath: images/copper-concentration-2026-01-26.png expectedResult: | 智利銅產量結構性衰退分析

結論：是的，智利銅產量已出現明顯的結構性衰退。

⏵關鍵數據 ┌──────────┬─────────────────────────────────┐ │ 指標 │ 數值 │ ├──────────┼─────────────────────────────────┤ │ 份額峰值 │ 37.2% (2004年) │ ├──────────┼─────────────────────────────────┤ │ 當前份額 │ 23.5% (2023年) │ ├──────────┼─────────────────────────────────┤ │ 累計回撤 │ -13.7 pp（損失約1/3峰值份額） │ ├──────────┼─────────────────────────────────┤ │ 絕對產量 │ 5.41 → 5.25 Mt（-3%，近乎持平） │ └──────────┴─────────────────────────────────┘

結構性衰退的三個特徵
1. 份額持續下滑 — 從 2004 年高點的 37.2% 一路下滑至 23.5%，下降趨勢持續近 20 年，並無反轉跡象
2. 絕對產量停滯 — 儘管全球銅需求從 14.5 Mt 增長至 22.4 Mt (+54%)，智利產量幾乎原地踏步（5.25 Mt vs 峰值 5.41 Mt）
3. 替代國崛起 — 2023 年秘魯+剛果(金)合計份額 (25.2%) 首次超越智利 (23.5%)，標誌著全球銅供應格局的歷史性轉折
視覺化

上圖顯示：
- 上半部：1970-2023 年各國份額演變（智利橙色區塊明顯收縮）
- 下半部：智利 vs 秘魯+剛果 — 2023 年出現「黃金交叉」
衰退成因（市場敘事）
- 礦石品位下降（Escondida、Collahuasi 等大型礦區老化）
- 水資源短缺（阿塔卡馬沙漠礦區依賴海水淡化）
- 環保法規趨嚴、原住民土地爭議
- 新礦投資週期拉長（許可審批 5-10 年）
question: '如果需求以年化 3% 成長，10 年後供需缺口多大？' expectedResult: | ─10 年銅供需缺口預測

核心假設
┌───────────────┬──────────────────────┐ │ 參數 │ 數值 │
├───────────────┼──────────────────────┤
│ 基準年 (2023) │ 22.36 Mt │ ├───────────────┼──────────────────────┤ │ 需求增長 │ +3%/年（用戶假設） │ ├───────────────┼──────────────────────┤ │ 供應增長 │ +2.0%/年（歷史趨勢） │ └───────────────┴──────────────────────┘

2033 年缺口預測 ┌────────────────────┬───────────┬─────────┬────────┐ │ 情景 │ 2033 供應 │ 缺口 │ 缺口率 │ ├────────────────────┼───────────┼─────────┼────────┤ │ A: 供應停滯 (0%) │ 22.4 Mt │ +7.7 Mt │ 25.6% │ ├────────────────────┼───────────┼─────────┼────────┤ │ B: 歷史趨勢 (2%) │ 27.4 Mt │ +2.7 Mt │ 8.9% │ ├────────────────────┼───────────┼─────────┼────────┤ │ C: 供應加速 (2.5%) │ 28.6 Mt │ +1.4 Mt │ 4.7% │ └────────────────────┴───────────┴─────────┴────────┘

關鍵發現

按歷史趨勢（情景B）：
- 2033 年需求：30.1 Mt（較今 +34%）
- 2033 年供應：27.4 Mt
- 單年缺口：2.7 Mt（約等於當前智利年產量的一半）
- 10 年累計缺口：13.6 Mt（約 0.6 年的當前全球產量）
智利衰退的額外拖累：
- 若智利延續 -0.9%/年衰退 → 2033 年產量降至 4.8 Mt
- 額外損失 ~0.5 Mt（相對於維持現狀）
結論

需求 3%/年 vs 供應 2%/年的 1% 缺口看似不大，但：
1. 缺口逐年擴大 — 從 2024 年的 0.2 Mt 擴大到 2033 年的 2.7 Mt
2. 累計效應顯著 — 10 年累計短缺 13.6 Mt
3. 智利無法填補 — 全球最大產國正在衰退而非擴張
→ 需要秘魯、剛果(金)、印尼等新興產區大幅擴產，或需求增速放緩，否則銅價中期面臨結構性支撐。

qualityScore: overall: 70 badge: 白銀 evaluatedAt: "2026-01-24"

metrics: problemFit: 80 correctness: 72 dataGovernance: 70 robustness: 65 maintainability: 70 usability: 73

metricDetails: problemFit: score: 80 strengths: - 五命題框架完整對應市場常見敘事 - 輸入參數設計涵蓋多種分析需求 - 多 workflow 設計支持漸進式分析 improvements: - 可增加 mine-level 品位數據支援

correctness:
  score: 72
  strengths:
    - HHI/CR4/CR8 計算公式明確
    - 結構斷點偵測方法論清晰
    - replacement_ratio 定義合理
  improvements:
    - 需增加 examples/ golden case
    - 地緣風險指數計算需更多驗證

dataGovernance:
  score: 70
  strengths:
    - OWID + USGS 雙來源設計
    - 數據分層策略明確（Tier 0-3）
  improvements:
    - GDELT 整合需實際測試
    - 需增加 data-sources.md 完整文檔

robustness:
  score: 65
  strengths:
    - 口徑先行原則降低混淆風險
    - 數據來源有 fallback 設計
  improvements:
    - 需增加 failure-modes.md
    - 缺值處理策略需更明確

maintainability:
  score: 70
  strengths:
    - Router pattern 分離職責
    - 參數定義完整
  improvements:
    - 需增加 version 更新日誌
    - 單元測試覆蓋需提升

usability:
  score: 73
  strengths:
    - 輸出模板包含 TL;DR 與依據
    - 五命題對應五組問答
  improvements:
    - 可增加歷史事件對照
    - 可增加即時監控儀表板

details: | 任務適配度（80/100） - 五命題框架對應市場敘事 - 多 workflow 支持漸進分析 - 待改進：增加 mine-level 支援

**正確性（72/100）**
- 集中度與斷點計算方法明確
- 待改進：增加 examples/ golden case

**資料治理（70/100）**
- OWID + USGS 雙來源設計
- 待改進：增加 data-sources.md

**穩健性（65/100）**
- 口徑先行降低混淆
- 待改進：增加 failure-modes.md

**可維護性（70/100）**
- Router pattern 設計
- 待改進：增加單元測試

**輸出可用性（73/100）**
- 五命題對應五組問答
- 待改進：增加歷史對照

upgradeNotes: targetBadge: 黃金 requirements: - metric: robustness currentScore: 65 targetScore: 75 suggestion: 增加 failure-modes.md 與缺值處理 - metric: correctness currentScore: 72 targetScore: 80 suggestion: 增加 examples/ golden case 與回歸測試

bestPractices:

title: 口徑先行 description: 分析前務必確認數據口徑（mined/refined/reserves），避免將儲量與產量混淆
title: 敘事轉指標 description: 任何市場說法（如「智利衰退」）必須對應量化指標（斜率、斷點、回撤）
title: 替代依賴度 description: 計算 replacement_ratio 時考慮執行風險，ratio ≈ 1 不代表安全
title: 供應慣性 description: 使用 10 年 lead time 約束評估供應反應，避免過度樂觀

pitfalls:

title: 儲量幻覺 description: 將儲量排名等同於供應安全 consequence: 智利儲量第一但產量可能下滑，高估供應穩定性
title: 單一指標 description: 只看 HHI 不看趨勢變化 consequence: 錯過集中度正在惡化的動態訊號
title: 忽略品位 description: 不考慮礦石品位下滑對產量的影響 consequence: 低估維持產量所需的資源投入
title: 地緣風險低估 description: 將地緣政治視為短期事件而非結構性風險 consequence: 對秘魯罷工、DRC 衝突等慢變量準備不足

faq:

question: 為什麼用 HHI 而不是 CR4？ answer: | HHI 對份額差異更敏感。例如：
- 4 國各 25% → CR4=100%, HHI=2500
- 1 國 70% + 3 國各 10% → CR4=100%, HHI=5200
HHI 能區分「均勻分佈」與「一國獨大」的風險差異。
question: 智利產量下滑是暫時還是結構性的？ answer: | 本 Skill 使用三指標判定：
1. 趨勢斜率（近 N 年是否持續負向）
2. 結構斷點（是否有明顯轉折年）
3. 峰值回撤（從高點跌了多少）
三項均為負面 → 結構性衰退只有斜率負向 → 可能是週期性調整
question: GDELT 地緣風險指數可靠嗎？ answer: | GDELT 是公開事件資料庫，優點是免費且覆蓋廣。局限性：
- 新聞導向，可能放大短期事件
- 需要設計合適的篩選關鍵字
建議作為輔助參考，非決策唯一依據。
question: 如何驗證數據準確性？ answer: | 使用雙來源交叉驗證：
1. OWID Minerals 作為 baseline
2. USGS MCS 作為官方口徑驗證
3. 差異 > 5% 時標記並說明可能原因

about: repository: https://github.com/fatfingererr/macro-skills branch: main additionalInfo: | ## 設計背景

此技能源於對「銅供應風險被低估」這類敘事的量化驗證需求。
常見說法包括：
- 「只有 10-12 國有顯著產量」
- 「智利像銅礦的 OPEC」
- 「品位下滑導致成本上升」
- 「未來只能依賴秘魯和剛果金」

本 Skill 將這些敘事轉化為可驗證的指標與情境分析。

## 關鍵洞察

1. **集中度確實高**：前 4-5 國控制超過 60% 產量
2. **智利趨勢轉向**：2016-2018 後產量增長停滯
3. **替代依賴風險**：秘魯勞工問題、DRC 政治不穩定
4. **供應反應慢**：新礦開發週期 10-15 年

## 使用場景

- 投資者評估銅礦股的地緣風險
- 分析師驗證市場流行敘事
- 策略師設計供應鏈多元化方案
- 研究者建立銅市場結構性分析框架