claude-code/claude-finance/skills/session-tracking/SKILL.md

246 lines
8.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
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 次,建議暫停觀察