Trade Journal

Trade Journal

Track trades and compare execution against the investment plan.

Arguments

• /trade-journal log — Record a new trade (manual or auto-detect from position changes)
• /trade-journal review — Show recent trades and compare to plan
• /trade-journal summary — Monthly P&L summary
• /trade-journal auto — 只做倉位變動偵測（不需手動輸入）

Step 0: 配置同步 & 倉位偵測

0a. 每次必做

• 讀取 plan.md — 掌握計畫中的待辦操作，用於判斷交易是否「按計畫執行」
• 讀取 feedback/*.md — 套用交易風格偏好

0b. 倉位取得與 journal 判斷（auto 例外）

1. 若 action 是 auto → 無論今天是否已偵測，都重新執行完整偵測（這是 auto 的主要功能）
2. 若 action 是 log/review/summary：

• 呼叫 mcp__firstrade-server__get_account_position 取得即時持倉
• 檢查 journal/YYYY-MM-DD.md（今天日期）是否已存在
• 若已存在 → 跳過偵測，使用即時持倉進入主流程
• 若不存在 → 執行完整偵測（見下方 Auto-Detect）

---

Workflow

Auto-Detect（完整偵測流程）

倉位變動自動偵測（後減前）：

1. 呼叫 mcp__firstrade-server__get_account_position 取得即時持倉（後 = 最新倉位）
2. 找到 journal/ 目錄下最新的 .md 檔案（前 = 上次快照）
3. 解析「前」檔案的倉位表格：

• 現股：從「現股持倉」或 Stocks 表格提取 {ticker: quantity}
• 選擇權：從「選擇權持倉」或 Options 表格提取 {contract: quantity}

1. 解析「後」（即時持倉）的倉位表格：同上
2. 比較差異：

股票： `` for each ticker in 後: if ticker not in 前 → 「🆕 新建倉：{ticker} {qty} 股」 if ticker in 前 and qty changed → 「📈 加碼 / 📉 減碼：{ticker} {前qty} → {後qty}」 for each ticker in 前: if ticker not in 後 → 「🔴 已清倉：{ticker} {前qty} 股」 ``

選擇權： `` 比較合約名稱（Symbol + Strike + Expiry + Type） 新合約 → 「🆕 新開倉」 消失的合約 → 「🔴 已平倉/到期」 數量變化 → 「加減倉」 ``

1. 輸出偵測結果給用戶確認：

``` ## ⚡ 自動偵測到的倉位變動（vs 上次快照 YYYY-MM-DD）

| 類型 | 操作 | 標的 | 變化 | 計畫對應 | |------|------|------|------|----------| | 股票 | 🆕 新建倉 | DDOG | 57 股 | ✅ SaaS建倉計畫 #1 | | 股票 | 🔴 清倉 | DY | 18 股 | ❓ 非計畫操作 | ```

1. 計畫對應：比對 plan.md 的待辦清單

• 如果交易匹配計畫中的操作 → 標記 ✅ 並引用計畫編號
• 如果是計畫外操作 → 標記 ❓ 提醒用戶記錄原因

Log a Trade

1. 如果 auto-detect 已偵測到變動 → 以偵測結果為基礎，詢問用戶補充：

• 交易價格（auto-detect 無法得知）
• 交易原因
• 是否按計畫執行

1. 如果用戶手動提供交易資訊 → 直接記錄
2. 建立/更新檔案：journal/YYYY-MM-DD.md

日記檔案格式：

# 交易日誌 — YYYY/MM/DD

## 帳戶總覽
| 項目 | 數值 |
|------|------|
| 股票市值 | $XXX,XXX |
| 選擇權市值 | $XX,XXX |
| 總資產 | ~$XXX,XXX |
| 今日變動 | +/- $X,XXX (+/- X.XX%) |
| 總損益 | +/- $X,XXX (+/- X.XX%) |

## 今日交易
| 時間 | 操作 | 代碼 | 合約 | 數量 | 價格 | 金額 | 計畫對應 |
|------|------|------|------|------|------|------|----------|
（若為自動偵測，時間欄填「—」，價格欄填「待確認」）

## 交易後倉位變化摘要
- TICKER: 前 → 後（描述）

## 現股持倉
| 代碼 | 股數 | 現價 | 成本 | 市值 | 損益 | 損益% |
|------|------|------|------|------|------|-------|
（從即時持倉取得，作為下次比較的快照）

## 選擇權持倉
| 代碼 | 合約 | 數量 | 現價 | 成本 | 市值 | 損益 | 損益% |
|------|------|------|------|------|------|------|-------|
（從即時持倉取得）

## 備註
- 用戶補充的交易原因和覆盤筆記

1. 記錄完成後，檢查是否需要更新配置計畫：

• 提示用戶：「此交易是否需要更新 plan.md？」

Review

1. 讀取 journal/ 目錄下所有檔案
2. 讀取 plan.md
3. 生成：

## Trade Review

### 計畫執行進度
| # | 計畫操作 | 狀態 | 執行日期 | 備註 |
（從配置計畫的「待執行操作」逐項對照）

### 計畫外交易
| 日期 | 操作 | 標的 | 原因 |

### 交易統計（本月）
- 總交易次數: XX
- 勝率: XX%
- 平均盈利: XX%
- 平均虧損: XX%
- 最佳交易: ...
- 最差交易: ...

Summary

1. 計算月度 P&L
2. 選擇權收入統計（premium 收入 vs 到期損益）
3. 組合價值變化趨勢
4. 計畫執行率（完成 / 總待辦）

File Structure

journal/
├── 2026-03-03.md    ← 每日一檔（含完整倉位快照）
├── 2026-03-04.md
└── ...

Create the trade-journal directory if it doesn't exist.

重要：倉位快照

每個 journal 檔案都必須包含完整的「現股持倉」和「選擇權持倉」表格， 這是下次「後減前」比較的數據來源。沒有快照就無法偵測變動。

Output Language

Use Traditional Chinese (繁體中文) for all text output.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: PatrickSUDO
• Source: PatrickSUDO/fadacai-portfolio
• License: MIT

Install and usage instructions live in the source repository linked above.