跳到正文
cccskills
免费在 GitHub 公开

commodity-analysis

Analyze crude oil, gold, and copper using supply and demand, inventories, futures prices, and seasonal patterns. Combine these factors with macroeconomic conditions to produce research reports showing market direction, confidence, and specific risks.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Commodity analysis (oil supply-demand balance / gold pricing / copper as an economic predictor / inventory cycles / futures premium-discount structure / seasonality), generating directional commodity signals.

查看安装方法

适用场景

  • Assess crude oil supply and demand
  • Review gold drivers such as real rates and the dollar
  • Study copper inventories and economic signals
  • Compare futures price structure with seasonal patterns

包含的文件(1)

  • SKILL.md8.9 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Commodity Analysis

Overview

Analyze commodities from four dimensions — supply-demand balance, pricing model, inventory cycle, and futures structure — and output directional signals suitable for backtesting. Focuses on crude oil (global pricing anchor), gold (safe haven + inflation hedge), and copper (economic barometer).

Core Concepts

1. Crude Oil Supply-Demand Balance

Key supply-side variables:

VariableData SourceFrequencyDirection of Impact
OPEC productionOPEC monthly reportMonthlyProduction cuts → oil price ↑
US shale outputEIA weekly reportWeeklyHigher output → oil price ↓
Rig count (Baker Hughes)Baker HughesWeeklyLeads production by 3-6 months
Strategic Petroleum Reserve (SPR)EIAWeeklySPR release → short-term oil price ↓

Key demand-side variables:

  • IEA global oil demand forecast (quarterly)
  • China crude imports (customs monthly data)
  • US gasoline demand (EIA weekly report, implied demand)
  • Global PMI (leads demand by 1-2 months)

Supply-demand balance signals:

# Simplified supply-demand judgment
if opec_compliance > 90% and us_rig_count_declining:
    supply_signal = "tight"  # bullish for oil
elif opec_compliance < 80% and us_production_rising:
    supply_signal = "loose"  # bearish for oil

if global_pmi > 50 and china_import_yoy > 5%:
    demand_signal = "strong"  # bullish for oil
elif global_pmi < 48 and china_import_yoy < 0:
    demand_signal = "weak"    # bearish for oil

2. Gold Pricing Framework

Four-factor model:

FactorWeightLogicIndicator
Real rates40%Real rates ↓ → lower opportunity cost of holding gold → gold ↑10Y TIPS yield
US dollar index25%USD ↓ → gold becomes cheaper in pricing terms → gold ↑DXY
Safe-haven demand20%Risk ↑ → safe-haven buying → gold ↑VIX + geopolitical risk index
Central-bank buying15%Central-bank purchases → structural demand supportWGC quarterly report

Practical rules:

  • 10Y TIPS < 0%: strong support for gold (negative real rates mean negative holding cost)
  • 10Y TIPS > 2%: pressure on gold (positive real rates reduce attractiveness)
  • Correlation between DXY and gold is around -0.6, but not absolute (they both rose in 2022 due to safe-haven demand)
  • Central-bank purchases >1000 tons / year (2022-2023 level): long-term structural bullish support

3. Dr. Copper as an Economic Predictor

Copper as a leading indicator:

  • YoY copper-price change leads industrial production by about 2-3 months
  • Copper / gold ratio is highly positively correlated with the US 10Y Treasury yield (r > 0.7)
  • Copper breakout above the prior high confirms economic recovery

Copper fundamental tracking:

IndicatorData SourceThreshold
LME copper inventoryLME daily report<150k tons = tight
SHFE copper inventorySHFE weekly reportWoW decline >10% = tight
Copper concentrate TC/RCSMMTC < $30/ton = tight mining supply
China copper importsCustoms monthly reportYoY growth >10% = strong demand

4. Inventory Cycle Analysis

Visible inventory vs hidden inventory:

  • Visible inventory: published by exchanges (LME / SHFE / COMEX), transparent and trackable
  • Hidden inventory: bonded areas / trader warehouses, opaque but potentially larger
  • The true turning point in prices is the turning point in total inventory

Four inventory-cycle stages (using copper as example):

Active restocking (price↑ volume↑) -> Passive restocking (price↓ volume↑) -> Active destocking (price↓ volume↓) -> Passive destocking (price↑ volume↓)
      mid bull market                 late bull market                 mid bear market                 late bear / early bull market

Signal mapping:

StageInventory DirectionPrice DirectionTrading Signal
Passive destocking↓↑Long (best buying point)
Active restocking↑↑Keep long positions
Passive restocking↑↓Close longs (warning)
Active destocking↓↓Short or stay neutral

5. Futures Premium / Discount Structure

Contango (futures > spot, normal market):

  • Supply is abundant, and the market prices in carrying costs (storage + funding)
  • Roll yield is negative (roll yield < 0), unfavorable for long holders
  • Deep contango (far month - near month > 5%) = severe oversupply

Backwardation (futures < spot, inverted market):

  • Supply is tight, and spot premium reflects strong immediate demand
  • Roll yield is positive (roll yield > 0), favorable for long holders
  • Deep backwardation (near month - far month > 3%) = squeeze or extreme shortage

Term-structure signal:

# Spread ratio = (front month - second month) / front month
spread_ratio = (front_month - second_month) / front_month

if spread_ratio > 0.02:    # backwardation > 2%
    signal = "strongly bullish"  # spot shortage
elif spread_ratio < -0.03: # contango > 3%
    signal = "bearish"           # oversupply
else:
    signal = "neutral"

6. Seasonality

Oil seasonality:

  • March-May: refinery maintenance ends + summer inventory build → seasonal rise (ahead of the "driving season")
  • September-October: hurricane season (Gulf of Mexico) → supply disruption → higher volatility
  • November-December: heating-oil demand → stronger diesel crack spread

Gold seasonality:

  • January-February: Lunar New Year + Indian wedding-season physical demand → relatively strong
  • July-August: traditional soft season → relatively weak
  • October-November: Diwali + Christmas restocking → relatively strong

Copper seasonality:

  • March-April: China construction season starts → demand recovery
  • June-July: off-season inventory buildup → pressure
  • September-October: "Golden September, Silver October" → demand recovery

Analysis Framework

Five-Step Commodity Analysis

  1. Supply-demand sets direction: is the balance in surplus or shortage? Which way are marginal variables moving?
  2. Inventory sets rhythm: which inventory-cycle stage are we in? Is a turning point close?
  3. Term structure confirms: contango or backwardation? Does it confirm the supply-demand judgment?
  4. Seasonality overlay: is seasonality currently a tailwind or a headwind?
  5. Macro validation: do the dollar / rates / risk appetite support the directional judgment?

Composite Scoring Template

commodity_score = {
    "supply_demand": +1,    # supply-demand is tight
    "inventory_cycle": +2,  # passive destocking (best stage)
    "term_structure": +1,   # mild backwardation
    "seasonality": 0,       # neutral seasonality
    "macro_env": -1,        # stronger dollar is a headwind
}
# Total score = +3/5 = +0.6 -> bullish bias, but not a strong signal

Output Format

## Commodity Analysis Report — [Commodity Name]

### Supply-Demand Structure
- Supply side: [surplus / balanced / shortage] — [specific data]
- Demand side: [strong / stable / weak] — [specific data]
- Balance table: [inventory build X tons / drawdown X tons]

### Inventory Cycle
- Current stage: [active restocking / passive restocking / active destocking / passive destocking]
- Visible inventory: [LME X tons, SHFE X tons, WoW change]

### Term Structure
- Front-back spread: [contango X% / backwardation X%]
- Roll yield: [positive / negative]

### Composite Score
| Dimension | Score(-2~+2) | Basis |
|------|------------|------|
| Supply-demand | +1 | OPEC compliance rate 92% |
| Inventory | +2 | LME inventory hit 18-month low |

### Trading Direction
- Direction: [bullish / bearish / neutral]
- Confidence: [high / medium / low]
- Risk points: [specific risks]

Notes

  • Commodity data sources are fragmented (EIA / OPEC / LME / SHFE, etc.). This skill provides the analytical framework; data should be retrieved through web-reader or entered manually
  • Futures prices include roll costs, so direct comparison across different contracts must account for expiry-roll effects
  • Seasonal patterns are statistical averages and may be completely overwhelmed by fundamentals in a given year
  • Gold has both commodity and financial attributes, and the financial side (rates / dollar) usually dominates short-term pricing
  • Copper’s financial characteristics have strengthened since 2020 (copper futures are used as a macro hedge), so pure fundamental analysis may be insufficient
  • Inventory data is lagged (hidden inventories cannot be tracked in real time), so cross-check with price and basis behavior
  • This framework is for research backtesting only and does not constitute investment advice

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Compare a Chinese company's US depositary receipts, Hong Kong shares, and mainland shares after adjusting for exchange rates and share ratios. Analyze pricing gaps, valuation differences, and delisting risks to support research into its different listings.

中文简介正在准备中。当前显示英语简介。

  • Compare A-share and H-share pricing gaps
  • Measure ADR premiums against Hong Kong shares
  • Review US delisting risks and Hong Kong listing alternatives
HKUDS/Vibe-Trading3.6万2026年10月19日 更新

akshare

免费

Retrieve stock prices, futures quotes, exchange rates, and economic indicators with the free Python library AKShare. The skill explains market-specific functions, symbol formats, and data preparation for analysis and testing strategies against historical data.

中文简介正在准备中。当前显示英语简介。

  • Retrieve historical prices for Chinese, US, and Hong Kong stocks
  • Collect Chinese GDP and consumer price data
  • Check futures quotes and foreign exchange rates
HKUDS/Vibe-Trading3.6万2026年10月19日 更新

alpha-zoo

免费

Explore bundled libraries of investment factors, signals used to compare securities, and inspect individual formulas and metadata. Evaluate a factor or an entire library across a chosen universe and period, producing aggregate performance statistics and an HTML report.

中文简介正在准备中。当前显示英语简介。

  • Find bundled momentum or reversal factors
  • Inspect a named factor's formula and metadata
  • Compare a factor library across a chosen universe and period
HKUDS/Vibe-Trading3.6万2026年10月19日 更新

Assess whether a Chinese A-share company may receive ST or *ST risk warnings next financial year. Review financial forecasts, dividends, audit opinions, and regulatory penalties, then report risk severity separately from confidence in the prediction.

中文简介正在准备中。当前显示英语简介。

  • Reviewing a Chinese A-share company's future ST risk
  • Assessing escalation risk for an existing ST or *ST stock
  • Checking revenue, equity, and dividend warning signs
HKUDS/Vibe-Trading3.6万2026年10月19日 更新

Plan portfolio allocations across assets using risk, correlations, return forecasts, and trading costs. Compare five optimization methods, produce settings for config.json, and define rebalancing rules that adjust holdings back toward their target weights.

中文简介正在准备中。当前显示英语简介。

  • Comparing allocations across stocks, bonds, and gold
  • Choosing an optimizer based on return forecasts and correlations
  • Preparing portfolio settings for config.json
HKUDS/Vibe-Trading3.6万2026年10月19日 更新

Diagnose failed or abnormal backtests, which test trading strategies on historical data. Inspect result files, strategy code, and configuration to identify bugs, make targeted repairs, rerun tests, and verify the updated metrics.

中文简介正在准备中。当前显示英语简介。

  • Investigating backtest execution errors
  • Finding why a strategy produces no trades
  • Checking delayed trades or low capital usage
HKUDS/Vibe-Trading3.6万2026年10月19日 更新

查看 HKUDS 的全部技能

报告此技能的问题