fadacai-portfolio: Skill for Claude Code

Portfolio Briefing

三層結構的每日投資組合簡報，取代原 /daily-briefing。

Arguments

• /briefing → Quick（~1 分鐘）
• /briefing full → Quick + Full（~3 分鐘）
• /briefing deep → Quick + Full + Deep（~5 分鐘）
• /briefing telegram → Telegram Push Tier（~2-3 分鐘）— 盤中推送專用，不跑 Phase 1-3

--send 旗標

任何 tier 加上 --send 會在 tier 執行完後：

1. 把完整 briefing markdown 寫到 briefing-out/YYYY-MM-DD-full.md（Write tool）
2. 把 Telegram 格式純文字寫到 briefing-out/YYYY-MM-DD-telegram.txt（Write tool）
3. 呼叫 python3 tools/send_briefing.py YYYY-MM-DD（Bash tool）推送至 Telegram + Email
   • send_briefing.py 內部自動呼叫 generate_html.py，push HTML 到 reports repo，並在 Telegram 訊息末加上網頁連結

briefing telegram 沒有 --send 時：只寫 briefing-out/ 兩個檔案，不發送。 若需手動生成 HTML（不發送）：python3 tools/generate_html.py briefing YYYY-MM-DD [--push]

執行模型建議

• /briefing（quick）→ Sonnet 5（純彙整；session 已長則先 /compact）
• /briefing telegram → Sonnet 5（每日 launchd 自動推送，成本敏感，固定 Sonnet；週五 --codex 另走 gpt-5.5）
• /briefing full → Opus 5.5（中等綜合 + Verdict；Phase 2 subagent 已外包 Sonnet 5）
• /briefing deep → Opus 5.5（深度合成 + Codex 整合 + 機率/EV）

切換方式：/model sonnet、/model opus 或 /model fable 後執行 skill。

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

執行 AGENTS.md 的 Step 0 統一規範（0a → 0b → 0c → 0d → 0e）。

• 讀 plan.md + feedback/*.md（必做）
• 呼叫 get_account_position 取即時持倉
• 今日 journal 不存在 → 執行 gap-fill + 變動偵測 + 自動建立 journal
• 若偵測到的變動對應 plan.md 待辦項 → 在 Phase 1 Step 1 標記
• 0e 第一性原理紀律：在 Quick Take 之前必須完成「市場主題 thesis / 證偽條件 / 機率分布」三題（見 AGENTS.md 0e）

Step 0.5: Macro Snapshot Load（所有 Phase / Tier 共用）

讀 cache（不打 API，所有數據由 tools/fetch_macro.py 預載到 briefing-out/cache/macro-snapshot.json）：

Read briefing-out/cache/macro-snapshot.json

判定：

• status == "ok" 或 "partial" 且 cache mtime < 36h → 使用，在 Quick Take 區前顯示 1 行：

  📊 Macro: Fed {fed_funds}% | 2s10s {value} ({regime}) | HY OAS {value} ({regime}, pct {pct_1y}%) | VIX {value} ({regime}) | regime: {regime_tag}
  

• status == "skipped"（FRED key 缺失）→ 顯示 ⚠️ Macro snapshot unavailable (FRED_API_KEY not set) 並跳過
• mtime > 36h → 顯示 ⚠️ Macro snapshot stale ({mtime_hours}h old) 仍使用但標記