# forecast — 前瞻預測

板塊與個股的短中長期前瞻預測。不看今日漲幅，看未來走勢方向。從總經→板塊→個股層層推演。

## 觸發方式
使用者輸入：`forecast [TARGET]`
範例：`forecast 半導體`、`forecast NVDA`、`forecast 台股 AI`

## 輸入
- `target`：板塊名稱、個股代號、或市場（可選，留空則做全市場板塊預測）

## 執行步驟

每個步驟的 Agent 至少進行 **3 回合討論**：

### Step 1: 讀取歷史預測（READ — 必須執行）
- **Agent**: `forecast_analyst`
- **知識庫**: `session_tracking.md`
- **任務**: 掃描 `docs/fin/sessions/` 下所有 `forecast-*.md`，找到最近一次預測，比對實際走勢
- **存在** → 在報告開頭標註上次預測準確度
- **不存在** → 標註「🆕 首次預測」

### Step 2: 總經方向判讀
- **Agent**: `forecast_analyst` + `sector_scout`
- **知識庫**: `macro_sector.md`
- **任務**: 景氣循環定位、Fed 利率路徑、領先指標趨勢
- **輸出**: 未來 1 個月 / 3 個月 / 6-12 個月的總經方向

### Step 3: 板塊輪動預測
- **Agent**: `forecast_analyst` + `sector_scout`
- **知識庫**: `macro_sector.md`
- **任務**: 基於總經方向，預測各板塊短中長期表現
- **輸出**: 短期最強/最弱 3 個板塊、中期超配/低配、長期戰略配置

### Step 4: 個股預測（如指定個股或板塊內代表股）
- **Agent**: `forecast_analyst` + `technical_analyst` + `fundamental_analyst`
- **知識庫**: `technical_analysis.md`, `valuation.md`, `sentiment_altdata.md`
- **任務**: 短中長期方向預測 + 目標區間 + 信心度
- **輸出**: 個股三時間框架預測表

### Step 5: 首席分析師整合
- **Agent**: `chief_analyst`
- **知識庫**: 全部
- **任務**: 交叉驗證各 Agent 預測，標註分歧與不確定性

### Step 6: 強制存檔（WRITE — 必須執行）
- 建立 `docs/fin/sessions/forecast-[今日日期].md`
- 填入：總經判斷、板塊預測（短中長期）、個股預測、信心度
- 如涉及特定個股，同時更新該個股 Session

### Step 7: 確認輸出（CONFIRM — 必須顯示）
在輸出最末尾顯示：
```
📁 預測 Session 已建立: docs/fin/sessions/forecast-[日期].md
📊 上次預測準確度: [準確率或「首次預測」]
```

## 輸出格式

```
# 前瞻預測報告 — YYYY-MM-DD

## 一、總經方向
景氣階段: [復甦/擴張/過熱/衰退]
Fed 路徑: [升息/暫停/降息]
總經評分: [擴張 ⬆️ / 中性 ➡️ / 收縮 ⬇️]

## 二、板塊預測

### 短期（1-4 週）看好
| 板塊 | 方向 | 信心度 | 驅動因素 | 代表 ETF |
|------|------|--------|---------|---------|

### 中期（1-3 月）超配
| 板塊 | 方向 | 信心度 | 驅動因素 | 代表 ETF |
|------|------|--------|---------|---------|

### 長期（3-12 月）戰略配置
| 板塊 | 方向 | 信心度 | 驅動因素 | 代表 ETF |
|------|------|--------|---------|---------|

## 三、個股預測

### [TICKER] — [公司名稱]

| 時間框架 | 方向 | 目標區間 | 信心度 | 關鍵假設 |
|---------|------|---------|--------|---------|
| 短期 1-4 週 | ⬆️/⬇️/➡️ | $XX - $XX | 🟢🟡🔴 | |
| 中期 1-3 月 | | | | |
| 長期 3-12 月 | | | | |

**短期催化劑**: [近期事件]
**中期關注**: [盈餘/產業趨勢]
**長期邏輯**: [結構性成長/估值]
**風險**: [最大下行風險]

→ 想交易？執行 trade-plan [TICKER]
→ 想深入？執行 deep-dive [TICKER]

## 四、風險提示
⚠️ [主要不確定性]
⚠️ [需要追蹤的變數]

## 五、預測追蹤
本報告已存檔至 Session，下次 forecast 時會回顧準確度。
```

## 涉及 Agent
`forecast_analyst`, `sector_scout`, `technical_analyst`, `fundamental_analyst`, `chief_analyst`