本技能聚焦於一個特殊的宏觀情境:勞動市場明顯轉弱,但 GDP 仍處高位。這種組合歷史上常伴隨:
- 財政赤字/GDP 的階躍式上升(自動穩定器 + 反週期支出)
- 長天期國債供給壓力增加
- 期限溢酬的潛在上升
關鍵洞察:「30 年歷史顯示,當 jobs 夠軟,赤字/GDP 會從 6–7% 跳到 12–17%」
核心度量方式:
- UJO = Unemployed_Level / Job_Openings_Level(失業人數/職缺比)
- ΔUR = Unemployment_Rate(t) - Unemployment_Rate(t-6M)(半年變化)
- 薩姆規則 = 3M_MA(UR) - min(UR over last 12M)(觸發式警報,≥0.5 為衰退警示)
這些指標用於定義「勞動轉弱事件」的觸發與分級(輕/中/重)。
基於 2000-2025 年歷史回歸分析的核心經濟彈性:
| 係數 |
數值 |
意涵 |
| β_UR |
0.59 |
失業率每↑1ppt → 赤字/GDP↑0.59ppt |
| β_UJO |
0.69 |
UJO每↑1 → 赤字/GDP↑0.69ppt |
| β_JOLTS |
-0.07 |
職缺每↑1M → 赤字/GDP↓0.07ppt |
| Lag |
4Q |
勞動指標領先赤字約4季 |
這些彈性係數用於:
- 情境投影的定量推演
- 驗證事件分組區間法的結果一致性
- 敏感度分析
詳細方法論見 references/methodology.md。
「高 GDP」量化為:
- GDP_level_percentile:GDP 水平在回看期間的分位數(例如 > 70% 視為高位)
- GDP_growth_regime:成長仍為正、或僅小幅趨緩
- (進階)產出缺口/趨勢偏離
只有同時滿足「勞動轉弱」+「高 GDP」條件的樣本,才納入情境分析。
| 模型 |
用途 |
輸出形式 |
| event_study_banding |
事件分組區間法 |
「12–17%」範圍型敘事,歷史事件清單 |
| quantile_mapping |
分位數映射 |
「現在落在歷史哪個角落」的條件分布 |
| robust_regression |
穩健迴歸推演 |
連續型情境路徑與區間 |
預設使用 event_study_banding,最貼近「歷史顯示…」的敘事方式。
本技能支援生成三軸圖表:
- 左軸:失業人數(紅色)、職缺數(藍色)— 千人
- 右軸:財政赤字/GDP(綠色)— 百分比
- 標註:歷史 crossover 事件(失業 > 職缺)及對應的赤字跳升幅度
- 情境投影:虛線顯示未來可能的路徑(mild/moderate/severe)
圖表基於 FRED 公開數據繪製,便於追蹤勞動-財政關聯的歷史演變。
本技能使用無需 API key 的公開資料來源:
- FRED CSV:
https://fred.stlouisfed.org/graph/fredgraph.csv?id={SERIES_ID}
- 勞動:UNRATE, UNEMPLOY, JTSJOL, ICSA
- 宏觀:GDP, GDPC1
- 財政:FYFSGDA188S(聯邦盈餘/赤字占 GDP)
- BEA: 備用的 GDP/財政數據源
腳本位於 scripts/ 目錄,可直接執行。
- 建構勞動鬆緊指標:從 FRED 數據計算 UJO、薩姆規則 等
- 定義背離事件:識別「勞動轉弱 + GDP 高位」的歷史樣本
- 推估赤字區間:使用三種模型估算 Deficit/GDP 的可能跳升區間
- 生成情境解讀:產出對長天期 UST 的供給/利率風險解讀
- 視覺化輸出:生成三軸圖表與情境投影
輸出:診斷資訊、赤字區間投影、歷史事件樣本、UST 風險解讀、視覺化圖表。
最快的方式:執行預設情境分析
cd skills/analyze-high-unemployment-high-gdp-growth-fiscal-deficit-scenarios
pip install pandas numpy requests matplotlib # 首次使用
python scripts/analyzer.py --quick
生成視覺化圖表(推薦):
python scripts/analyzer.py --visualize --scenario-type moderate
或直接使用視覺化腳本:
python scripts/visualizer.py --scenario moderate --years 25
輸出範例:
{
"skill": "analyze_high_unemployment_fiscal_deficit_scenarios",
"as_of": "2026-01-21",
"diagnostics": {
"current_slack_percentile": 0.28,
"high_gdp_condition": true,
"triggered_labor_softening": false
},
"deficit_gdp_projection": {
"baseline_deficit_gdp": 0.062,
"conditional_range_next_8q": {
"p25": 0.11, "p50": 0.135, "p75": 0.16
},
"n_episodes": 3
}
}
完整情境分析 + 圖表:
python scripts/analyzer.py --lookback 30 --horizon 8 --model event_study_banding --visualize --scenario-type severe --output result.json --chart-output chart.png
- 快速診斷 - 查看目前的勞動/GDP 狀態與赤字風險判定
- 完整情境分析 - 執行完整的歷史事件研究與赤字區間推估
- 視覺化圖表 - 生成三軸圖表與情境投影
- 自訂情境推演 - 輸入自訂的失業衝擊情境進行推演
- 方法論學習 - 了解勞動-財政連結的邏輯與模型
- UST 風險解讀 - 生成長天期美債的供給/利率風險報告
請選擇或直接提供分析參數。
路由後,閱讀對應文件並執行。
方法論: references/methodology.md
- 勞動-財政連結邏輯
- 三種分析模型詳解
- 事件分組與門檻定義
資料來源: references/data-sources.md
- FRED 系列代碼(勞動/GDP/財政)
- 數據頻率與對齊方法
輸入參數: references/input-schema.md
| Script |
Command |
Purpose |
| analyzer.py |
--quick |
快速診斷當前狀態 |
| analyzer.py |
--lookback 30 --horizon 8 |
完整情境分析 |
| analyzer.py |
--visualize --scenario-type moderate |
分析 + 視覺化圖表 |
| visualizer.py |
--scenario moderate --years 25 |
單獨生成視覺化圖表 |
| visualizer.py |
--scenario severe --output chart.png |
指定輸出路徑 |
| fetch_data.py |
--series UNRATE,JTSJOL,GDP |
抓取 FRED 資料 |
|
|
|
核心參數
| 參數 |
類型 |
預設值 |
說明 |
| country |
string |
US |
國家代碼 |
| lookback_years |
int |
30 |
回看年數 |
| frequency |
string |
quarterly |
資料頻率 |
| horizon_quarters |
int |
8 |
推演季度數 |
| model |
string |
event_study_banding |
分析模型 |
| output_format |
string |
json |
輸出格式 |
勞動指標設定
| 參數 |
類型 |
預設值 |
說明 |
| use_jolts |
bool |
true |
使用 JOLTS |
| use_unemployment |
bool |
true |
使用失業率 |
| use_sahm_rule |
bool |
true |
計算 薩姆規則 |
| slack_metric |
string |
unemployed_to_job_openings_ratio |
鬆緊度量 |
視覺化參數
| 參數 |
類型 |
預設值 |
說明 |
| visualize |
bool |
false |
是否生成視覺化圖表 |
| scenario_type |
string |
moderate |
情境類型 (mild/moderate/severe) |
| chart_output |
string |
auto |
圖表輸出路徑 |
| no_show |
bool |
false |
不顯示圖表(僅保存) |
情境假設
| 參數 |
類型 |
預設值 |
說明 |
| gdp_path |
string |
high_gdp_sticky |
GDP 路徑假設 |
| unemployment_shock |
object |
{type, size, speed} |
失業衝擊設定 |
完整參數定義見 references/input-schema.md。
完整輸出結構見 templates/output-json.md。
數據分析
視覺化(若啟用)
1---2name: analyze-high-unemployment-high-gdp-growth-fiscal-deficit-sce3description: 在「失業率走高/勞動市場轉弱」但「名目或實質 GDP 仍維持高位(或仍在成長)」的情境下,依據歷史關聯估算美國財政赤字占 GDP(Deficit/GDP)可能擴張的區間,並生成對長天期美債(長久期 UST)供給/利率風險的情境解讀。支援視覺化圖表輸出。4---56<essential_principles>78<principle name="labor_gdp_divergence">9**勞動-GDP 背離核心邏輯**1011本技能聚焦於一個特殊的宏觀情境:**勞動市場明顯轉弱,但 GDP 仍處高位**。這種組合歷史上常伴隨:12- 財政赤字/GDP 的階躍式上升(自動穩定器 + 反週期支出)13- 長天期國債供給壓力增加14- 期限溢酬的潛在上升1516關鍵洞察:「30 年歷史顯示,當 jobs 夠軟,赤字/GDP 會從 6–7% 跳到 12–17%」17</principle>1819<principle name="slack_metric">20**勞動鬆緊度量 (Slack Metric)**2122核心度量方式:23- **UJO** = Unemployed_Level / Job_Openings_Level(失業人數/職缺比)24 - 能捕捉「職缺掉很快、失業還沒上來」的早期轉弱階段25- **ΔUR** = Unemployment_Rate(t) - Unemployment_Rate(t-6M)(半年變化)26- **薩姆規則** = 3M_MA(UR) - min(UR over last 12M)(觸發式警報,≥0.5 為衰退警示)2728這些指標用於定義「勞動轉弱事件」的觸發與分級(輕/中/重)。29</principle>3031<principle name="elasticity_coefficients">32**彈性係數 (Elasticity Coefficients)**3334基於 2000-2025 年歷史回歸分析的核心經濟彈性:3536| 係數 | 數值 | 意涵 |37|-------------|-----------|----------------------------------|38| **β_UR** | **0.59** | 失業率每↑1ppt → 赤字/GDP↑0.59ppt |39| **β_UJO** | **0.69** | UJO每↑1 → 赤字/GDP↑0.69ppt |40| **β_JOLTS** | **-0.07** | 職缺每↑1M → 赤字/GDP↓0.07ppt |41| **Lag** | **4Q** | 勞動指標領先赤字約4季 |4243這些彈性係數用於:44- 情境投影的定量推演45- 驗證事件分組區間法的結果一致性46- 敏感度分析4748詳細方法論見 `references/methodology.md`。49</principle>5051<principle name="high_gdp_condition">52**高 GDP 條件定義**5354「高 GDP」量化為:55- **GDP_level_percentile**:GDP 水平在回看期間的分位數(例如 > 70% 視為高位)56- **GDP_growth_regime**:成長仍為正、或僅小幅趨緩57- (進階)產出缺口/趨勢偏離5859只有同時滿足「勞動轉弱」+「高 GDP」條件的樣本,才納入情境分析。60</principle>6162<principle name="three_models">63**三種分析模型**6465| 模型 | 用途 | 輸出形式 |66|-------------------------|----------------|------------------------------------|67| **event_study_banding** | 事件分組區間法 | 「12–17%」範圍型敘事,歷史事件清單 |68| **quantile_mapping** | 分位數映射 | 「現在落在歷史哪個角落」的條件分布 |69| **robust_regression** | 穩健迴歸推演 | 連續型情境路徑與區間 |7071預設使用 `event_study_banding`,最貼近「歷史顯示…」的敘事方式。72</principle>7374<principle name="visualization">75**三軸視覺化圖表**7677本技能支援生成三軸圖表:78- **左軸**:失業人數(紅色)、職缺數(藍色)— 千人79- **右軸**:財政赤字/GDP(綠色)— 百分比80- **標註**:歷史 crossover 事件(失業 > 職缺)及對應的赤字跳升幅度81- **情境投影**:虛線顯示未來可能的路徑(mild/moderate/severe)8283圖表基於 FRED 公開數據繪製,便於追蹤勞動-財政關聯的歷史演變。84</principle>8586<principle name="data_access">87**資料取得方式**8889本技能使用**無需 API key** 的公開資料來源:90- **FRED CSV**: `https://fred.stlouisfed.org/graph/fredgraph.csv?id={SERIES_ID}`91 - 勞動:UNRATE, UNEMPLOY, JTSJOL, ICSA92 - 宏觀:GDP, GDPC193 - 財政:FYFSGDA188S(聯邦盈餘/赤字占 GDP)94- **BEA**: 備用的 GDP/財政數據源9596腳本位於 `scripts/` 目錄,可直接執行。97</principle>9899</essential_principles>100101<objective>102實作「高失業 + 高 GDP」情境下的財政赤字推估:1031041. **建構勞動鬆緊指標**:從 FRED 數據計算 UJO、薩姆規則 等1052. **定義背離事件**:識別「勞動轉弱 + GDP 高位」的歷史樣本1063. **推估赤字區間**:使用三種模型估算 Deficit/GDP 的可能跳升區間1074. **生成情境解讀**:產出對長天期 UST 的供給/利率風險解讀1085. **視覺化輸出**:生成三軸圖表與情境投影109110輸出:診斷資訊、赤字區間投影、歷史事件樣本、UST 風險解讀、視覺化圖表。111</objective>112113<quick_start>114115**最快的方式:執行預設情境分析**116117```bash118cd skills/analyze-high-unemployment-high-gdp-growth-fiscal-deficit-scenarios119pip install pandas numpy requests matplotlib # 首次使用120python scripts/analyzer.py --quick121```122123**生成視覺化圖表(推薦)**:124```bash125python scripts/analyzer.py --visualize --scenario-type moderate126```127128**或直接使用視覺化腳本**:129```bash130python scripts/visualizer.py --scenario moderate --years 25131```132133輸出範例:134```json135{136 "skill": "analyze_high_unemployment_fiscal_deficit_scenarios",137 "as_of": "2026-01-21",138 "diagnostics": {139 "current_slack_percentile": 0.28,140 "high_gdp_condition": true,141 "triggered_labor_softening": false142 },143 "deficit_gdp_projection": {144 "baseline_deficit_gdp": 0.062,145 "conditional_range_next_8q": {146 "p25": 0.11, "p50": 0.135, "p75": 0.16147 },148 "n_episodes": 3149 }150}151```152153**完整情境分析 + 圖表**:154```bash155python scripts/analyzer.py --lookback 30 --horizon 8 --model event_study_banding --visualize --scenario-type severe --output result.json --chart-output chart.png156```157158</quick_start>159160<intake>161需要進行什麼操作?1621631. **快速診斷** - 查看目前的勞動/GDP 狀態與赤字風險判定1642. **完整情境分析** - 執行完整的歷史事件研究與赤字區間推估1653. **視覺化圖表** - 生成三軸圖表與情境投影1664. **自訂情境推演** - 輸入自訂的失業衝擊情境進行推演1675. **方法論學習** - 了解勞動-財政連結的邏輯與模型1686. **UST 風險解讀** - 生成長天期美債的供給/利率風險報告169170**請選擇或直接提供分析參數。**171</intake>172173<routing>174| Response | Action |175|------------------------------|--------------------------------------------|176| 1, "快速", "quick", "診斷" | 執行 `python scripts/analyzer.py --quick` |177| 2, "完整", "full", "情境" | 閱讀 `workflows/analyze.md` 並執行 |178| 3, "視覺化", "圖表", "chart" | 閱讀 `workflows/visualize.md` 並執行 |179| 4, "自訂", "custom", "推演" | 閱讀 `workflows/scenario.md` 並執行 |180| 5, "學習", "方法論", "why" | 閱讀 `references/methodology.md` |181| 6, "UST", "美債", "利率" | 閱讀 `workflows/ust-risk.md` 並執行 |182| 提供參數 (如 lookback_years) | 閱讀 `workflows/analyze.md` 並使用參數執行 |183184**路由後,閱讀對應文件並執行。**185</routing>186187<directory_structure>188```189analyze-high-unemployment-high-gdp-growth-fiscal-deficit-scenarios/190├── SKILL.md # 本文件(路由器)191├── skill.yaml # 前端展示元數據192├── manifest.json # 技能元數據193├── workflows/194│ ├── analyze.md # 完整情境分析工作流195│ ├── visualize.md # 視覺化圖表工作流196│ ├── scenario.md # 自訂情境推演工作流197│ └── ust-risk.md # UST 風險解讀工作流198├── references/199│ ├── data-sources.md # FRED 系列代碼與資料來源200│ ├── methodology.md # 勞動-財政連結方法論201│ └── input-schema.md # 完整輸入參數定義202├── templates/203│ ├── output-json.md # JSON 輸出模板204│ └── output-markdown.md # Markdown 報告模板205├── scripts/206│ ├── analyzer.py # 主分析腳本(含視覺化整合)207│ ├── visualizer.py # 視覺化專用腳本208│ └── fetch_data.py # 數據抓取工具209└── output/ # 圖表輸出目錄210 └── (generated charts)211```212</directory_structure>213214<reference_index>215216**方法論**: references/methodology.md217- 勞動-財政連結邏輯218- 三種分析模型詳解219- 事件分組與門檻定義220221**資料來源**: references/data-sources.md222- FRED 系列代碼(勞動/GDP/財政)223- 數據頻率與對齊方法224225**輸入參數**: references/input-schema.md226- 完整參數定義227- 預設值與建議範圍228229</reference_index>230231<workflows_index>232| Workflow | Purpose | 使用時機 |233|--------------|--------------|--------------------|234| analyze.md | 完整情境分析 | 需要歷史事件研究時 |235| visualize.md | 視覺化圖表 | 需要生成圖表時 |236| scenario.md | 自訂情境推演 | 輸入自訂失業衝擊時 |237| ust-risk.md | UST 風險解讀 | 需要債市風險報告時 |238</workflows_index>239240<templates_index>241| Template | Purpose |242|--------------------|-------------------|243| output-json.md | JSON 輸出結構定義 |244| output-markdown.md | Markdown 報告模板 |245</templates_index>246247<scripts_index>248| Script | Command | Purpose |249|---------------|----------------------------------------|--------------------|250| analyzer.py | `--quick` | 快速診斷當前狀態 |251| analyzer.py | `--lookback 30 --horizon 8` | 完整情境分析 |252| analyzer.py | `--visualize --scenario-type moderate` | 分析 + 視覺化圖表 |253| visualizer.py | `--scenario moderate --years 25` | 單獨生成視覺化圖表 |254| visualizer.py | `--scenario severe --output chart.png` | 指定輸出路徑 |255| fetch_data.py | `--series UNRATE,JTSJOL,GDP` | 抓取 FRED 資料 |256</scripts_index>257258<input_schema_summary>259260**核心參數**261262| 參數 | 類型 | 預設值 | 說明 |263|------------------|--------|---------------------|------------|264| country | string | US | 國家代碼 |265| lookback_years | int | 30 | 回看年數 |266| frequency | string | quarterly | 資料頻率 |267| horizon_quarters | int | 8 | 推演季度數 |268| model | string | event_study_banding | 分析模型 |269| output_format | string | json | 輸出格式 |270271**勞動指標設定**272273| 參數 | 類型 | 預設值 | 說明 |274|------------------|--------|----------------------------------|---------------|275| use_jolts | bool | true | 使用 JOLTS |276| use_unemployment | bool | true | 使用失業率 |277| use_sahm_rule | bool | true | 計算 薩姆規則 |278| slack_metric | string | unemployed_to_job_openings_ratio | 鬆緊度量 |279280**視覺化參數**281282| 參數 | 類型 | 預設值 | 說明 |283|---------------|--------|----------|---------------------------------|284| visualize | bool | false | 是否生成視覺化圖表 |285| scenario_type | string | moderate | 情境類型 (mild/moderate/severe) |286| chart_output | string | auto | 圖表輸出路徑 |287| no_show | bool | false | 不顯示圖表(僅保存) |288289**情境假設**290291| 參數 | 類型 | 預設值 | 說明 |292|--------------------|--------|---------------------|--------------|293| gdp_path | string | high_gdp_sticky | GDP 路徑假設 |294| unemployment_shock | object | {type, size, speed} | 失業衝擊設定 |295296完整參數定義見 `references/input-schema.md`。297298</input_schema_summary>299300<output_schema_summary>301```json302{303 "skill": "analyze_high_unemployment_fiscal_deficit_scenarios",304 "inputs": {305 "country": "US",306 "lookback_years": 30,307 "slack_metric": "unemployed_to_job_openings_ratio",308 "model": "event_study_banding"309 },310 "diagnostics": {311 "current_slack_percentile": 0.28,312 "high_gdp_condition": true,313 "triggered_labor_softening": false314 },315 "elasticity_model": {316 "parameters": {317 "beta_ur": 0.59,318 "beta_ujo": 0.69,319 "beta_jolts": -0.07,320 "lag_quarters": 4321 },322 "interpretation": {323 "ur_effect": "每 1ppt 失業率上升 → 赤字/GDP 上升 0.59 ppt",324 "ujo_effect": "UJO 每上升 1 → 赤字/GDP 上升 0.69 ppt",325 "lag_effect": "勞動指標領先赤字約 4 季"326 },327 "conditional_means": {328 "deficit_when_loose": 5.6,329 "deficit_when_tight": 5.2330 }331 },332 "deficit_gdp_projection": {333 "baseline_deficit_gdp": 0.062,334 "conditional_range_next_8q": {335 "p25": 0.11, "p50": 0.135, "p75": 0.16, "min": 0.095, "max": 0.175336 },337 "n_episodes": 3,338 "episode_years": ["2001-2003", "2008-2010", "2020-2021"]339 },340 "interpretation": {341 "macro_story": "...",342 "ust_duration_implications": [...],343 "watchlist_switch_indicators": [...]344 },345 "visualization": {346 "chart_path": "output/fiscal_deficit_scenario_20260121.png",347 "scenario_type": "moderate",348 "projected_deficit_jump_bps": 600349 }350}351```352353完整輸出結構見 `templates/output-json.md`。354</output_schema_summary>355356<success_criteria>357執行成功時應產出:358359**數據分析**360- [ ] 當前勞動鬆緊狀態(分位數、是否觸發轉弱)361- [ ] 高 GDP 條件判定結果362- [ ] Deficit/GDP 的條件分布區間(p25/p50/p75)363- [ ] 歷史樣本事件清單(年份、指標數值)364- [ ] UST 供給壓力通道解讀365- [ ] 風險偏好通道解讀(避險 vs 供給兩股力量)366- [ ] 監控切換指標清單367- [ ] 診斷資訊(當前指標數值)368369**視覺化(若啟用)**370- [ ] 三軸圖表(職缺/失業/赤字GDP)371- [ ] 歷史 crossover 事件標註372- [ ] 情境投影虛線(mild/moderate/severe)373- [ ] 衰退期灰色陰影374- [ ] JSON 摘要檔案375</success_criteria>