claude-code/antigravity-finance/.context/session_tracking.md

---
name: session-tracking
description: Session 延續性追蹤知識庫。Session 檔案結構、更新規則、歷史比對邏輯、跨指令數據共享。
---

# Session 延續性追蹤

## ⚠️ 強制存檔規則（所有指令必須遵守）

**每次執行任何分析指令後，必須完成以下存檔步驟，不得跳過：**

### 存檔三步驟

1. **READ（讀取）**：分析開始前，先用 Read 工具檢查 `docs/fin/sessions/[TICKER]-session.md` 是否存在
   - 存在 → 讀取完整內容，在分析中引用歷史數據
   - 不存在 → 記住稍後要建立新檔案

2. **ANALYZE（分析）**：執行正常分析流程

3. **WRITE（寫入）**：分析結束後，**必須**用 Write 工具執行以下操作：
   - 不存在 → 建立新的 Session 檔案（使用下方完整模板）
   - 已存在 → 更新 Session 檔案（保留歷史，追加新紀錄）
   - **寫入後，必須在輸出末尾顯示確認訊息**：
     ```
     📁 Session 已更新: docs/fin/sessions/[TICKER]-session.md
     ```

### 存檔路徑規則

| 類型 | 路徑 |
|------|------|
| 個股 | `docs/fin/sessions/[TICKER]-session.md` |
| 產業 | `docs/fin/sessions/sector-[產業名]-session.md` |
| 預測 | `docs/fin/sessions/forecast-[日期].md` |

**路徑必須先確保目錄存在**：如果 `docs/fin/sessions/` 不存在，先建立目錄。

### ⚠️ 同日同股合併規則（嚴格執行）

**相同日期 + 相同股票/標的 = 只能寫入同一個 Session 檔案，禁止建立多個檔案。**

| 情境 | 正確做法 | ❌ 錯誤做法 |
|------|---------|-----------|
| 今天已對 NVDA 做過 `/deep-dive`，又做 `/trade-plan` | 追加到 `NVDA-session.md` 的分析歷史表格 | 建立 `NVDA-session-2.md` 或 `NVDA-trade-session.md` |
| 今天對 NVDA 做了 3 次不同指令 | 全部追加到同一個 `NVDA-session.md` | 建立 3 個不同檔案 |
| 不同天對 NVDA 做分析 | 追加到同一個 `NVDA-session.md`（新增一行歷史） | 建立 `NVDA-session-0228.md` |

**合併邏輯**：
1. 檔名永遠是 `[TICKER]-session.md`（個股）或 `sector-[名稱]-session.md`（產業）
2. 同一天多次分析 → 在「分析歷史」表格追加多行，每行標註不同指令
3. 不同天分析 → 同樣追加到同一個檔案，用日期區分
4. **永遠不要在檔名中加入日期、序號、指令名稱等後綴**

## 完整 Session 檔案模板

**建立新 Session 時，必須使用以下完整模板，不得省略任何區塊：**

```markdown
# [TICKER/產業] 分析 Session

## 基本資訊
- 建立日期: YYYY-MM-DD
- 最後更新: YYYY-MM-DD
- 狀態: 研究中
- 投資論述: [一句話描述為什麼關注這個標的]

## 分析歷史
| 日期 | 指令 | 摘要 | 報告路徑 |
|------|------|------|---------|
| YYYY-MM-DD | /[指令名] | [本次分析的一句話摘要] | docs/fin/[TICKER]-[日期]/ |

## 關鍵價位（最後更新: YYYY-MM-DD）
| 時間框架 | 支撐 | 壓力 | 狀態 |
|---------|------|------|------|
| 短期 | $XX | $XX | [描述] |
| 中期 | $XX | $XX | [描述] |
| 長期 | $XX | $XX | [描述] |

## 催化劑追蹤
| 催化劑 | 預期日期 | 狀態 | 結果 |
|--------|---------|------|------|
| [事件名] | YYYY-MM-DD | ⏳ 待兌現 | - |

## 交易紀錄
| 日期 | 動作 | 價格 | 數量 | 理由 |
|------|------|------|------|------|
| （尚未交易） | | | | |

## 計劃更新歷史
- YYYY-MM-DD: Session 建立（來自 /[指令名]）
```

## 更新 Session 時的規則

**更新已存在的 Session 時，必須：**

1. **保留所有歷史紀錄** — 不得刪除舊的分析歷史、催化劑、交易紀錄
2. **追加新紀錄** — 在「分析歷史」表格追加新行
3. **更新關鍵價位** — 用最新數據覆蓋，但在「計劃更新歷史」中記錄變更
4. **更新催化劑狀態** — 已兌現的標記 ✅/❌/➖，新增新的催化劑
5. **更新「最後更新」日期**
6. **更新「狀態」** — 根據分析結果調整（研究中/觀察中/已進場/已出場）

## 什麼是 Session？

Session 是一個**持續追蹤檔**，記錄你對某個標的或產業的所有分析歷史，確保每次分析不是從零開始，而是延續之前的結論。

## 存放位置

```
docs/fin/sessions/
├── NVDA-session.md           # 個股 Session
├── TSLA-session.md
├── sector-AI半導體-session.md  # 產業 Session
├── sector-電動車-session.md
└── forecast-2026-02-27.md    # 預測 Session
```

## Session 生命週期

```
建立 → 研究中 → 觀察中 → 已進場 → 已出場（或回到觀察中）
```

| 狀態 | 說明 | 觸發條件 |
|------|------|---------|
| 研究中 | 初始分析階段 | `/session-start` 或首次 `/deep-dive` |
| 觀察中 | 分析完成，等待時機 | `/deep-dive` 完成 |
| 已進場 | 已執行交易 | 手動更新或 `/trade-plan` 標記 |
| 已出場 | 交易結束 | 手動更新 |
| 暫停 | 暫時不追蹤 | 手動暫停 |

## 各指令的 Session 行為（強制步驟）

### `/deep-dive [TICKER]`
1. **READ**: 讀取 `docs/fin/sessions/[TICKER]-session.md`
2. **存在** → 在報告開頭標註「📋 延續上次分析（YYYY-MM-DD）」，比對關鍵價位變化
3. **不存在** → 標註「🆕 首次分析」
4. 執行四維分析
5. **WRITE**: 建立/更新 Session 檔案（填入關鍵價位、催化劑、分析摘要）
6. **CONFIRM**: 輸出末尾顯示 `📁 Session 已更新: docs/fin/sessions/[TICKER]-session.md`

### `/trade-plan [TICKER]`
1. **READ**: 讀取 Session
2. **存在** → 比對歷史計劃，標註價位變化
3. **不存在** → 標註「🆕 首次建立」
4. 執行交易計劃制定
5. **WRITE**: 建立/更新 Session（寫入交易計劃區塊）
6. **CONFIRM**: 輸出末尾顯示確認

### `/forecast [TARGET]`
1. **READ**: 讀取 `docs/fin/sessions/forecast-[最近日期].md`（如有）
2. **存在** → 比對上次預測 vs 實際走勢，計算準確度
3. 執行預測分析
4. **WRITE**: 建立 `docs/fin/sessions/forecast-[今日日期].md`
5. **CONFIRM**: 輸出末尾顯示確認

### `/portfolio-review`
1. **READ**: 掃描 `docs/fin/sessions/` 下所有 `*-session.md`
2. 逐一更新分析
3. **WRITE**: 更新每個 Session 檔案
4. **CONFIRM**: 輸出末尾列出所有已更新的 Session

### `/market-pulse`
1. **READ**: 讀取所有「已進場」狀態的 Session
2. 在報告中標註持倉標的今日表現
3. **WRITE**: 如果有新的異動標的值得追蹤，建立新 Session
4. **CONFIRM**: 輸出末尾顯示確認

### `/sector-pick [產業]`
1. 執行產業篩選
2. **WRITE**: 建立 `docs/fin/sessions/sector-[產業名]-session.md`
3. **CONFIRM**: 輸出末尾顯示確認

### `/replay`
1. 執行覆盤分析
2. **WRITE**: 如果涉及特定標的，更新其 Session 的「交易紀錄」和「計劃更新歷史」
3. **CONFIRM**: 輸出末尾顯示確認

## 更新規則

### 關鍵價位比對

每次更新時，必須比對：

```markdown
## 關鍵價位比對（YYYY-MM-DD 更新）

| 時間框架 | 上次支撐 | 當前支撐 | 變化 | 上次壓力 | 當前壓力 | 變化 |
|---------|---------|---------|------|---------|---------|------|
| 短期 | $A | $A' | ↑/↓/= | $B | $B' | ↑/↓/= |
| 中期 | $C | $C' | ↑/↓/= | $D | $D' | ↑/↓/= |
| 長期 | $E | $E' | ↑/↓/= | $F | $F' | ↑/↓/= |
```

### 催化劑狀態追蹤

| 狀態 | 符號 | 說明 |
|------|------|------|
| 待兌現 | ⏳ | 尚未發生 |
| 已兌現-正面 | ✅ | 結果正面 |
| 已兌現-負面 | ❌ | 結果負面 |
| 已兌現-中性 | ➖ | 影響不大 |
| 已過期 | 🕐 | 時間已過但未發生 |

### 計劃遵守度追蹤

每次更新時記錄：
- 是否按計劃進出場
- 是否遵守停損
- 是否遵守倉位限制
- 偏離計劃的原因

## 數據共享機制

Session 檔案是所有指令的**共享數據層**：

```
/sector-pick → 建立產業 Session
     ↓
/deep-dive → 讀取產業 Session，建立個股 Session
     ↓
/trade-plan → 讀取個股 Session，寫入交易計劃
     ↓
/portfolio-review → 讀取所有 Session，更新狀態
     ↓
/market-pulse → 讀取「已進場」Session，標註今日表現
```

## Session 歸檔

當標的已出場且不再追蹤時：
1. 將狀態改為「已出場」
2. 記錄最終損益
3. 記錄教訓
4. 檔案保留不刪除（作為歷史參考）

## 衝突處理

如果多次分析結論矛盾：
1. 以**最新**分析為準
2. 在 Session 中保留歷史記錄
3. 標註「結論變更」及原因
4. 如果短期內反覆變更 > 2 次，建議暫停觀察