# 📊 Stock-Flow | AI驅動股票分析決策系統

## 🎯 核心願景

**一套自動化的股票研究系統**，從「總經判斷 → 個股篩選 → 深度分析 → 決策執行」的完整閉環。

無需在多個平台之間切換，所有分析結果自動存檔、自動對比、自動生成決策建議。

---

## 🚀 快速開始 (5 大場景)

### 場景 1️⃣: 看總經環境（5 分鐘）

```bash
/cycle-lights
```

結果: 🟢 綠燈 | 🟡 黃燈 | 🔴 紅燈 + 11 項經濟指標 + 配置建議

---

### 場景 2️⃣: 找熱門標的（10 分鐘）⭐ **最推薦**

```bash
/quick-decision stock-scan 3
```

結果: 前 3 名標的排序 + 倉位建議 + 進場價 + 為什麼買

---

### 場景 3️⃣: 深度分析一隻股票（20 分鐘）

```bash
/full-analysis AAAA
```

結果: 完整決策報告（可買嗎→買多少→何時買→為什麼→什麼時候賣）

---

### 場景 4️⃣: 晨會快速總結（3 分鐘）⭐ **新增**

```bash
/daily-briefing
```

結果: 今日催化劑清單 + 持倉監控 + 市場環境 + 推薦標的 TOP 3

---

### 場景 5️⃣: 持倉監控警報（實時）⭐ **新增**

```bash
/position-monitor
```

結果: 實時監控 + 自動警報（停損/停利/催化劑推遲）

---

## 📚 完整 Workflow 地圖

### Tier 1: 單股基礎
| 指令 | 用途 | 時間 |
|------|------|------|
| `/stock-data [TICKER]` | 基礎數據 | 5-10 min |
| `/catalyst-check [TICKER]` | 催化劑時間表 | 5-8 min |
| `/risk-score [TICKER]` | 風險評分 | 3-5 min |
| `/entry-exit [TICKER]` | 進出場點 | 5-8 min |

### Tier 2: 整合決策
| 指令 | 用途 | 時間 |
|------|------|------|
| `/full-analysis [TICKER]` | 完整分析 | 15-25 min |
| `/quick-decision [STRATEGY] [COUNT]` | 快速決策 | 10-15 min |

### Tier 3: 篩選與排序
| 指令 | 用途 | 時間 |
|------|------|------|
| `/stock-scan` | 事件驅動 | 5-10 min |
| `/stock-scan-growth` | 成長股 | 5-10 min |
| `/stock-scan-value` | 價值股 | 5-10 min |
| `/stock-scan-momentum` | 技術趨勢 | 5-10 min |
| `/ranking [STRATEGY] [COUNT]` | 自動排序 | 5-8 min |
| `/risk-matrix review` | 組合風險 | 5-10 min |

### Tier 4-6: 監控與總經
| 指令 | 用途 | 時間 |
|------|------|------|
| `/cycle-lights` | 景氣循環燈號 | 10-15 min |
| `/daily-briefing` | 晨會快速總結⭐ | 3-5 min |
| `/position-monitor` | 持倉監控⭐ | 2-3 min |
| `/summary` | Session 彙整 | 5 min |

---

## 💡 核心特色

✅ **完全自動化決策** - 標的 → 數據 → 分析 → 評分 → 排序 → 決策  
✅ **時間維度加權催化劑** - 近期 × 1.2 倍 | 遠期 × 0.6 倍  
✅ **100 日均線中期分界** - > 100MA 看多 | < 100MA 看空  
✅ **期權牆 4 層分析** - 位置 + GEX + 移動趨勢 + 時間表  
✅ **組合風險 3 層防線** - 倉位上限 + 關聯性 + Greeks  
✅ **實時警報系統** - 催化劑推遲、期權異常、觸發停損自動通知  

---

## 📋 典型交易日工作流

```
8:00   /daily-briefing (3 min)
8:30   /quick-decision stock-scan 3 (10 min)
9:30   /position-monitor (實時監控)
下午    /full-analysis [TICKER] (15 min)
16:00  /position-monitor (3 min)
18:00  /summary (5 min)

全天: ~40 分鐘 | 決策品質: ⭐⭐⭐⭐⭐
```

---

## 📂 檔案結構

```
stock-flow/
├── .agent/workflows/
│   ├── cycle-lights.md         (總經分析)
│   ├── stock-scan*.md          (4 種篩選策略)
│   ├── stock-data.md           (基礎數據)
│   ├── catalyst-check.md       (催化劑)
│   ├── risk-score.md           (風險評分)
│   ├── entry-exit.md           (進出場)
│   ├── full-analysis.md        (完整分析)
│   ├── quick-decision.md       (快速決策)
│   ├── ranking.md              (排序)
│   ├── risk-matrix.md          (組合風險)
│   ├── daily-briefing.md       (晨會)⭐
│   ├── position-monitor.md     (持倉監控)⭐
│   └── summary.md              (彙整)
├── sessions/                   (自動存檔分析結果)
└── README.md                   (本檔案)
```

---

## 🤖 自動化方案全路線圖

### Phase 1: 基礎自動化 (1 週)
```
☑️ Cron 每日 08:00 執行 /daily-briefing
☑️ Slack 集成：所有警報推送到頻道
☑️ Session 自動存檔：每次分析自動紀錄
☑️ 交易平台 API 同步：自動讀取持倉
```

### Phase 2: 進階自動化 (2 週)
```
☑️ 盤中實時監控：每 5 分鐘掃描 /position-monitor
☑️ 期權牆實時更新：每 15 分鐘抓取數據
☑️ FDA/政府日程自動同步
☑️ 機構 13F 自動解析與警報
```

### Phase 3: 智能自動化 (4 週)
```
☑️ 風險評分下跌自動警報
☑️ 倉位調整自動建議
☑️ 機器學習優化催化劑預測
☑️ 歷史績效自動分析
```

### Phase 4: 完全自動執行 (6 週)
```
☑️ 一鍵交易自動執行 (風險分 > 80)
☑️ 動態止損追蹤
☑️ 組合自動再平衡 (每週)
☑️ 月度績效自動報告
```

---

## 🎓 建議使用方式

### 新手 (第 1 週)
1. 每天執行 `/quick-decision stock-scan 3` (10 分鐘)
2. 選出最強 1 檔執行 `/full-analysis` (20 分鐘)
3. 執行 `/summary` 彙整結果 (5 分鐘)
4. **時間投入**: ~35 分鐘/天

### 進階 (第 2-4 週)
1. 早上 `/daily-briefing` (3 分鐘)
2. 篩選出 3-5 檔執行 `/quick-decision` (10 分鐘)
3. 對前 2 名執行 `/full-analysis` (30 分鐘)
4. 全天 `/position-monitor` (實時)
5. 執行 `/summary` 彙整 (5 分鐘)
6. **時間投入**: ~50 分鐘/天

### 自動化 (第 5+ 週)
- 設置 Cron 每日早上 8:00 自動執行 `/daily-briefing`
- Slack 集成：所有警報自動推送
- 盤中實時監控 (系統自動執行)
- 收盤後自動執行 `/summary` 和績效分析
- **時間投入**: ~10 分鐘/天 (監控+決策)

---

## ✨ 最後一句話

**好的決策系統應該自動化 95% 的分析，保留 5% 的人工判斷。**

Stock-Flow 就是這樣的系統。祝交易順利！🚀

---

**版本**: v2.0 | **最後更新**: 2026-01-25