📐 理財筆記守則 — 給接手的 AI
維護「理財專區」的分析筆記（個股 / ETF）前先讀這份。持倉資料匯入另見 匯入指南。整體規矩見 repo 根
CLAUDE.md §9。
0. 三條硬規則（違反 = 出錯）
- 財務數字絕不捏造：股價、財報、估值倍數、分析師目標價、持股權重、費用率 —— 一律 web 查證權威來源並標查證日；查不到就寫「需查證」，不要憑印象填。
- 專有名詞中英對照：理財筆記讀者要中英並列（與醫學筆記「一律英文」不同）。例：
本益比 P/E、自由現金流 Free Cash Flow (FCF)、ADAS（先進駕駛輔助系統）。 - 據實、不美化：多空論點與風險都要寫；負面事實（虧損、債務、大股東 overhang、中概股風險）如實列出，不報喜不報憂。
1. 檔案位置與命名
| 類型 | 資料夾 | 檔名 |
|---|---|---|
| 個股 Stock | 理財(FIN)/筆記/個股分析/ | <代號>_<公司名>_analysis.md（如 MSFT_Microsoft_analysis.md） |
| ETF | 理財(FIN)/筆記/ETF分析/ | <代號>_analysis.md 或 <代號>_<簡稱>_analysis.md |
| 基本概念 | 理財(FIN)/筆記/基本概念/ | <主題>_overview.md |
ETF 與個股一律分開資料夾。
specialty: FIN。
2. 來源層級 Source Hierarchy（查證用）
- 一手：公司財報 / 法說（earnings release, 10-Q/10-K/8-K, investor relations）、ETF 官方 fact sheet / 公開說明書（prospectus）、SEC EDGAR。
- 市場資料：StockAnalysis、MacroTrends、Yahoo Finance、MarketBeat（估值 / 目標價 / 市值）。
- 財經權威衛教：Investopedia、Bogleheads、SEC investor.gov、CFA Institute、S&P SPIVA（觀念 / 定義）。
- 台灣稅費：財政部 / 國稅局 / 證交所（TWSE）。
每個財務數字都要能追到來源；文末 ## 📚 來源 Sources 附 URL。
3. 新分析筆記骨架（個股）
frontmatter（type: note, specialty: FIN, tags 含代號）→ 標題 → 更新行（含查證日）→ 以下區塊：
- 🏢 公司概況 Company Overview（代號、產業、市值、主營、護城河 moat）
- 🧩 商業模式與營收結構 Business Model & Segments（分部營收）
- 💰 財務表現 Financials（最新一季/年，標發布日；營收/獲利/利潤率/指引/特殊指標如 RPO）
- 📊 估值 Valuation（P/E、forward P/E、P/S、市值、分析師評級、目標價）
- 🧭 投資論點 Investment Thesis（看多 Bull / 看空 Bear 都要）
- ⚠️ 風險 Risks（據實）
- 🎯 我的持倉 My Position（連 dashboard、關注點）
- 🔗 相關筆記 Related（雙向 cross-link）
- 📚 來源 Sources（URL）
- footer：非投資建議 + 建立日
ETF 版骨架略不同：基本資料表（追蹤指數/費用率/持股數/AUM/殖利率）→ 這檔在買什麼 → 適合誰/怎麼用 → 風險 → 我的持倉 → 來源。參考現有 VTI / NASA。
直接複製現有筆記當範本（勿憑記憶重建）：MSFT 是個股標準版、_template_個股分析 是空白範本。
4. 更新既有分析（按日期補新內容）— 走 note-review 邏輯
- 判斷時效：看筆記頂端「資料更新至」與
modified；財報每季更新，超過一季就該查新。 - web 查最新：抓最新一季財報 + 當前估值/股價，與筆記現有數字比對。
- 更新：改動的數字就地更新，頂端「資料更新至」與 frontmatter
modified改當天；重大變化（財報大超/大missed、評級變、重大事件）在對應區塊補一段，可加🆕 <日期>標記。 - 保留脈絡：不要刪掉舊論點，除非已被推翻；被推翻的可註明「（原預期…，<日期>已改變）」。
- 一樣標查證日 + 附新來源。
5. 寫完必做（wiki 維護，等同 CLAUDE.md §3）
modified蓋當天日期。- 雙向 cross-link：新筆記
🔗 相關筆記連 2–4 篇；到 理財專區總覽 對應表格加一列；相關既有筆記補反向連結。 - 更新
_wiki_meta/index.md（FIN 區加列 + 檔頭日期）與_wiki_meta/log.md（最上方加一筆）。 - 跑
python3 _wiki_meta/lint.py確認 0 壞 wikilink / 0 壞 YAML。 - commit + push main（orchestrator 做唯一一次 commit）。
6. 雙重相容提醒（Obsidian + Quartz）
- 圖片用
![[檔名.png]]；內部連結[[完整相對路徑|顯示名]]；frontmatter 合法 YAML（見 CLAUDE.md §6）。 - 顏色/強調可用 inline
<span style="color:...">（QuartzrehypeRaw支援；台股慣例紅=正綠=負）。
🔗 相關
本檔是「給維護 AI 的守則」，非投資內容。