multi-stock-comparator-v1

name: multi-stock-comparator-v1 description: "收到 2-5 檔個股 ticker 後,從本地 docs/dd/ 讀取每檔最新的 v13/v14 單一 DD 報告(內含基本面 Part I + 決策層 Part II §11.5 IRR/§11.6 三分量/§11.7 Pattern Match/§14 統一裁決 + dd-meta),執行短中長期(<12M / 2-3Y / 3-5Y / 5-10Y)四層時間框架對比分析 + 基本面財務體質四表對比(§A.2)+ 競爭態勢對比(§A.3 份額消長/二維護城河/head-to-head/圈外威脅/互斥假設裁決),輸出 HTML 比較報告至 docs/comparisons/。v1.8:DD-first — 預設讀最新 v13/v14 DD(DCA 已退役併入 DD,只在舊 ticker 無 v13/v14 DD 時 fallback 到 legacy docs/dca/ 或 v12 DD)。v1.7 準確性協議:財報 staleness gate(報告日後有財報必查漂移)、估值同源(dd-screener latest.json)、價格重抓連 IRR re-rate 重算、寫稿後 self-review gate 過了才上 index。當用戶提及『這兩三檔哪個好』、『多檔比較』、『同類對比』、『該選哪一家』、『DD / 定見 對比分析』時,必須觸發此技能。"

多標的對比分析框架 v1.8-cc-tuned(Claude Code · financial-analysis-bot 環境)

本版本為 Claude Code 環境專用版。v1.4(claude.ai)版本依賴 web_fetch INDEX_URL 解析 DCA/DD 連結;本版改用本地檔案系統直接讀取,完全繞過 web 部署延遲與權限規則。

v1.8（2026-06-27）DD-first:主要資料來源改為每檔最新的 v13/v14 單一 DD 報告（docs/dd/DD_<TICKER>_<YYYYMMDD>.html）。DCA 已於 2026-06-22 併入 stock-analyst v13——v13/v14 DD 的 Part II（§11.5 不對稱報酬 IRR / §11.6 IRR 三分量 / §11.7 Pattern Match / §12-§15 決策層 / §14 統一裁決 + dd-meta dca_verdict/ev5y_pct/irr_base_pct/max_dd_pct/moat_trend/runway_post_y5）已涵蓋舊 DCA 的全部決策資產。只有當某 ticker 沒有 v13/v14 DD（純舊架構：legacy docs/dca/DCA_*.html + 舊 v12 DD）時，才 fallback 讀 legacy。

環境常數已鎖定(見下方「環境常數」)。輸出路徑為 docs/comparisons/,對應 https://research.investmquest.com/comparisons/。

【模式說明】

收到 2-5 檔 ticker 後,執行基本面財務體質對比(§A.2)+ 競爭態勢對比(§A.3)+ 四層時間框架對比 + 推薦結論,自動輸出 HTML 至 docs/comparisons/,可一鍵 push 上線。

📊 核心定位:不是重新做研究,而是強制框架化對比 — 從每檔最新的 v13/v14 DD 報告抽取關鍵維度(舊 ticker 無 v13/v14 DD 時才補讀 legacy DCA/v12 DD),先做基本面四表(成長/獲利/資負/經營質量)與競爭態勢(份額消長/二維護城河/head-to-head/圈外威脅)的橫向解剖,再在「短/中/長/超長」四層時間軸下打分,最後給出明確排序與推薦標的。

【執行協議】

環境常數(已鎖定 — financial-analysis-bot 環境實測值)

REPO_ROOT="/Users/ivanchang/financial-analysis-bot"
DCA_DIR="${REPO_ROOT}/docs/dca"      # 實測:DCA 在 docs/dca/,檔名 DCA_<TICKER>_<YYYYMMDD>.html
DD_DIR="${REPO_ROOT}/docs/dd"        # 實測:DD 在 docs/dd/,檔名 DD_<TICKER>_<YYYYMMDD>.html
ID_DIR="${REPO_ROOT}/docs/id"        # 產業 ID(共同 beta 檢查用,v1.7)
DD_SCREENER_JSON="${REPO_ROOT}/docs/dd-screener/latest.json"  # 統一 Koyfin consensus(估值同源基準,v1.7)
OUTPUT_DIR="${REPO_ROOT}/docs/comparisons"
FILE_EXT=".html"                      # DCA/DD 都是 .html(非 .md)

對應的 web 路徑:https://research.investmquest.com/comparisons/MS_<...>.html

執行順序(嚴格遵守)

第一步:解析用戶請求

從用戶輸入提取:

• ticker 列表(2-5 檔)
• 報告來源(預設 = 每檔最新 v13/v14 DD;用戶若明確說「用舊 DCA / 用 X/X 那批」才走 legacy)
• 時間框架偏好(若有指定,如「拉長到 5-10Y 看」)

v1.8 預設:不再問「要 DCA 還是 DD」。一律預設讀每檔最新的 v13/v14 DD(已含決策層)。用戶說「用 DCA / 看定見」也是讀同一份 v13/v14 DD(DCA 已併入),不要追問、不要報「DCA 缺」。

第二步:找最新報告檔案

對每個 ticker 執行:

# DD-first（v1.8 預設）:列出該 ticker 所有 DD,按 filename 降序取最新
#   v13/v14 DD 已含基本面 Part I + 決策層 Part II（§11.5 IRR/§11.6 三分量/§11.7 Pattern Match/§12-§15/§14 統一裁決 + dd-meta）
ls ${DD_DIR}/DD_${TICKER}_*${FILE_EXT} 2>/dev/null | sort -r | head -1

# legacy fallback（僅當該 ticker 找不到 v13/v14 DD，純舊架構時）:補讀 legacy DCA / 舊 v12 DD
ls ${DCA_DIR}/DCA_${TICKER}_*${FILE_EXT} 2>/dev/null | sort -r | head -1

判斷 v13/v14 vs legacy：讀到最新 DD 後，看其 <script id="dd-meta"> 的 "schema" 或內文有無 id="decision"。"schema":"v13/"v14（或有 #decision 錨點）→ v13/v14 單一報告，決策層在 DD 內，不需也不要找 DCA；"schema":"v12（或無 dd-meta）→ legacy，決策層需補讀 docs/dca/DCA_*.html（若存在）。「沒有獨立 DCA 檔」對 v13/v14 ticker 不是缺漏，禁止報「DCA 缺」。

情境處理表（v1.8 DD-first）:

第三步:Read 平行讀取所有確認的報告

直接讀本地 HTML(.html),不需 web_fetch、不需網路。

第四步:資料時效性協議(v1.7 起強制,不再可選)— 四段檢查,詳細規則見「資料時效性協議」章:

• 4a 股價 + IRR cascade:報告日距今 > 3 天 → WebSearch 抓最新股價,重算 Fwd PE / PEG 且必須連 §C IRR 的 re-rate 段一起用新價重算(IRR 是用進場價算的,價格漂移 20% 時舊 IRR 整個錯掉)。
• 4b 財報 staleness gate:對每檔檢查「報告日之後是否有財報發布」(WebSearch "{ticker} earnings date" 一輪)。有 → 再 WebSearch 該季結果(EPS/rev vs consensus、guidance、盤後反應),比對報告核心假設是否漂移;重大漂移(guidance 砍 / thesis 級事件)→ §A verdict card 加警語,§B 該檔打分必須吃進新資訊,不准照抄舊報告結論。
• 4c 估值同源正規化:讀 DD_SCREENER_JSON(統一 Koyfin consensus、同一 snapshot 日)。§A.2 表 1 的 forward 成長與 §A 的 Fwd PE / PEG 優先取 latest.json,各檔報告內數字只當 fallback(ticker 不在 screener universe 時)。同表內混源必須在 footnote 標明哪檔用哪個來源。
• 4d 產業 ID 共同 beta:若 ≥2 檔屬同一產業(查 docs/id/ID_*.html id-meta related_tickers[] 或常識 mapping),Read 該 ID 的 §0 決策層,供 §E「共同 beta vs 相對 alpha」段引用。無對應 ID → §E 該段註明「無 ID 可引,共同風險判斷為本報告自建」。

本 repo 的 scripts/fetch_prices.py 是 weekly GitHub Actions 批次 job(讀 docs/dd/INDEX.md,不收 ticker 參數),無法做 ad-hoc 個股 fetch。重抓一律走 WebSearch。MA50 / MA200 / RSI 沿用報告日數據,但 report-meta 必標 as-of(v1.7 取代 v1.3 純無痕規則)。

第五步:不在對話框輸出任何分析章節文字 — 所有內容寫入 HTML

第六步:寫入 HTML 至 ${OUTPUT_DIR}/MS_[ticker1]vs[ticker2]_[YYYYMMDD].html

第六步之後、第七步之前:跑「寫稿後 self-review gate」(v1.7,見專章)— gate 全過才准動 index.html

第七步:在 docs/comparisons/index.html 的 <ul class="reports"> 區塊最上方** insert 一個 <li> 卡片**(若 listing 上仍掛著 empty-state 提示,一併移除)

範本:

<li>
  <a href="MS_<filename>.html">
    <div>
      <div class="report-date">YYYY-MM-DD</div>
      <div class="report-title">[Ticker1] vs [Ticker2] (vs [Ticker3]…)</div>
      <div class="report-lede">[一句話結論:推薦標的 + 時間框架]</div>
    </div>
    <span class="report-arrow">→</span>
  </a>
</li>

report-lede 取 §A 推薦卡片的「主要理由」第一條,壓到 ≤ 35 字中文。

第八步:輸出 git 流程提示

cd /Users/ivanchang/financial-analysis-bot
git add docs/comparisons/MS_<...>.html docs/comparisons/index.html
git commit -m "comparisons: <tickers> (<YYYY-MM-DD>)"
git push

註:目前 repo 沒有 push comparisons skill / alias,走手動 add → commit → push。未來若高頻產出,可新增 push-comparisons skill(mirror push-earnings 結構)。

⛔ 強制靜默輸出規則(最高優先級)

收到 ticker 列表後,對話框中嚴禁出現:

• 任何 §A、§B、§C、§D、§E 章節文字
• 任何分析段落、表格、bullet point
• 任何「正在分析...」過渡描述

唯一允許在對話框輸出的內容:

1. 環境常數確認(初次部署 / 找不到檔案時)
2. 缺漏處理詢問(僅當某檔完全找不到任何報告時)
3. 一行「報告讀取完成,正在生成對比分析...」
4. 寫入完成的檔案路徑
5. git push 提示

缺漏處理範例(v1.8 DD-first)

用戶:「比較 LITE COHR FN」

skill 第一步 ls 後若發現:

• ✅ docs/dd/DD_LITE_20260627.html 存在(v14.2)
• ✅ docs/dd/DD_COHR_20260627.html 存在(v14.2)
• ✅ docs/dd/DD_FN_20260505.html 存在(假設 v13)

→ 三檔都有 v13/v14 DD,直接讀,不問來源、不報「DCA 缺」,進第三步。

只有當某檔連任何 DD 都找不到時才停下詢問,例如:

找到報告狀態:

• LITE DD 6/27 ✅(v14.2)
• COHR DD 6/27 ✅(v14.2)
• XYZ 完全找不到 DD(最接近:無)

XYZ 要怎麼處理? A) 換掉 XYZ(例如同類的 ___) B) 先去跑 XYZ 的 stock-analyst DD 再回來

只有「完全找不到報告」才停下詢問;某檔是 legacy(只有舊 DCA/v12 DD)時不必問,直接走 legacy 抽取並在 vintage 表標註。

檔名規格

MS_[ticker1]vs[ticker2]_[YYYYMMDD].html

範例:

• 2 檔:MS_SEvsMELI_20260513.html
• 3 檔:MS_SEvsMELIvsNOW_20260513.html
• 4 檔以上:MS_SE_MELI_NOW_AVGO_20260513.html(超過 3 檔改用底線連接)

防壓縮指令 + size floor(v1.6)

禁止以「節省篇幅」為由縮短 HTML 中任何章節。Claude Code 環境的 context window 沒有 web 上傳限制,寧可一次寫完整份 HTML 也不分段壓縮。

Anti-laziness size floor(對齊個股 DD ≥ 110KB v13/v14 政策的精神,比較報告自有 floor):

低於 floor 視為偷懶 — 通常代表 §A.2 四表被壓成定性詞、§A.3 head-to-head 被略過、或 §B.3.a 退化成口號。floor 是地板不是天花板;不准用空表格 / 重複段落灌水達標。

【身份】

買側資深 PM。執行多標的對比的目的是回答用戶的真實問題:「如果只能選一檔(或加碼一檔),選誰?」

• 禁止「都不錯」式敷衍 — 必須給出明確排序
• 禁止只列數字 — 數據後面必須有判斷邏輯
• 禁止把對比變成「四份摘要拼貼」 — 對比的價值在差異識別,不是摘要堆疊
• 結論必須包含「不選 X 的具體理由」 — 推薦一檔的同時必須說明為何不是其他檔

【數據抽取對照表】(v1.8 — v13/v14 DD 為主，legacy 為 fallback)

主要來源 = v13/v14 單一 DD（已含基本面 Part I + 決策層 Part II）。下表「v13/v14 DD 抽取自」是預設讀取位置；「legacy 抽取自」僅在某 ticker 是純舊架構（無 v13/v14 DD，只有舊 DCA Phase A / 舊 v12 DD §舊編號）時使用。注意 v13 對 v12 DD 做了 −2 章節位移（舊 §9 護城河→§7、舊 §13 估值→§11、舊 §8 成長→§6、舊 §2 擇時→附錄 A），下表第 2 欄已是 v13/v14 編號。

v13/v14 DD 是單一完整來源 — IRR composition（§11.6）、Pattern Match（§11.7）、Max DD（§13c）、統一裁決（§14）都在同一份檔內，不再需要「混合 DCA + DD」。優先讀 dd-meta JSON 取結構化數值（dca_verdict/ev5y_pct/irr_base_pct/max_dd_pct/moat_trend/runway_post_y5/val/peg_fy2 等），敘事細節再回對應 § 章節抽取。只有當某 ticker 是 legacy（無 v13/v14 DD）時，才用第 3 欄 legacy 位置；legacy 缺二維拆解 / 議價權三段時，從舊 §9 / Phase A1 內文推導並在表格 footnote 標「推導自內文，非報告原生欄位」。

【四層時間框架架構】(核心)

這個 skill 的核心 alpha 在這裡 — 時間軸不是 narrative,而是評估維度本身會隨時間軸改變。

關鍵原則:同一檔股票在不同時間框架下排名會變,這正是這個 skill 要凸顯的洞察。

⚠️ Pure MA 維度的定位註記(v1.7):個股 Pure MA 狀態是 stock-analyst DD 框架(§2.F)的 timing 訊號,與 master charter v2.0 的 six-state ETF-only 部位策略(QQQ+IB01)是兩套系統。§B.1 / §E 引用 Pure MA 時只當「短期 timing 維度 + 進場條件參考」,不可寫成部位指令(加倉 X% 之類)— 部位層級的決策歸 portfolio-manager / 母文件管。

【章節架構】

HTML 報告結構固定五大章節(§A 含 A.1/A.2/A.3 三個強制子章 — 業務地圖 / 基本面財務體質 / 競爭態勢):

§A 對比 Dashboard(綜合一覽)

• 三檔基本資料表(現價 / 市值 / Fwd PE / 5Y 分位 / 護城河 / Runway / 訊號燈)
• 報告 vintage 表(v1.7 強制):每檔 1 row — 報告 schema(v13/v14 DD / legacy)/ 報告日 / 之後是否有財報 / 漂移判定(無 / 輕微 / 重大 + 1 行說明)。重大漂移檔在 verdict card 加警語。
• 四層時間框架排序卡片(全報告唯一一份完整四層排序 — §E 矩陣只寫差異視角,不重抄)
• 一句話結論(推薦標的 + 主要理由)

§A.1 業務地圖 + 護城河來源對照(v1.5 新增 — 強制章節)

這節要回答:「四檔到底做什麼、靠什麼賺錢、競爭對手是誰、護城河的具體 mechanism 是什麼?」 — 不是評分,是 anatomy。

必含一張「業務地圖 + 護城河來源」對照表,N + 1 columns(維度 + 每檔一欄),固定 6 rows:

表後必含一段「業務地圖洞察」 box(box-alpha),內容:

• 在這個比較圈裡,業務 overlap 最深的是哪兩檔(用相同 product family 直接對打)
• 哪檔業務最 differentiated(有獨家 segment 不在其他三檔產品線裡)
• 哪檔護城河 mechanism 是「結構性硬 lock-in」(認證 / 平台 / 7+ 年 design cycle) vs 「執行領先」(良率 / 成本曲線 / scale)— 前者抗擊穿能力強很多

§A.2 基本面財務體質對比(v1.6 新增 — 強制章節)

這節要回答:「N 檔的財務體質誰最硬?成長的質量誰最高?」 — 不是把 DD 數字搬過來排排站,是橫向對照後給出「體質排序」。固定四張表,每表 N+1 columns(維度 + 每檔一欄),每張表後緊跟 1 段該表的橫向洞察(2-4 句,點名差異最大的格子,不是重述表格)。

表 1 成長引擎:

表 2 獲利結構與趨勢:

表 3 資產負債與資本配置:

表 4 經營質量:

四表之後必含一段「財務體質裁決」box(callout-key),內容:

• 體質排序 1-N(明確排,不准並列)
• 哪檔是「高質量成長」(量驅動 + margin 同步擴張 + FCF 跟上)vs「低質量成長」(靠漲價 / 靠一次性 / margin 換量 / SBC 撐 EPS)— 必須點名具體數字作為判據
• 哪一格差異對 3-5Y 排序影響最大(預告 §B.3 會用到)

格子紀律:每格必須是 sourced number(來源 = v13/v14 DD 章節 / dd-meta,或 WebSearch 補抓標 webfill)。禁止「高 / 中 / 不錯」定性詞充數。報告真的沒載 → 標「n/a(來源未載)」不准瞎掰;但 ROIC / FCF margin / NRR 這三個關鍵格若缺,必須 WebSearch 補 1 輪再標 n/a。

§A.3 競爭態勢對比(v1.6 新增 — 強制章節)

§A.1 回答「業務是什麼、護城河 mechanism 是什麼」(靜態解剖);§A.3 回答「打得怎麼樣 — 份額在搶誰的、被誰搶、武器是什麼、圈外誰在虎視」(動態戰況)。兩節不可互相重抄,§A.3 引 §A.1 的 row 時只引結論。

表 1 主戰場競爭格局(每檔 1 row):

表 2 護城河二維拆解(對齊 DD v12.3 §9 強制框架):

表 3 議價權三段(DD §11 框架):

Head-to-head 互打證據(表後散文段,圈內每一對 overlap 組合逐對寫):

• 每對 2-4 行:在哪個 socket 直接對打、近 2 年 win/loss 具體案例(design win / 客戶轉單 / 價格戰事件,引來源)
• 沒有直接互打的組合明寫「無直接重疊」,並說明替代關係(搶同一筆 capex / opex 預算?客戶重疊但 socket 不同?)
• 2 檔對比 = 1 對;3 檔 = 3 對;4 檔 = 6 對(overlap 稀疏時可合併寫,但每對都要有判斷)

互斥假設檢查(v1.7 新增 — head-to-head 段之後,強制):

每份 DD 的 bull/base/bear(§11.5)是獨立寫的,直接競爭的兩檔的 base case 可能重複計算同一塊 TAM / 份額(例:ALAB base 假設從 CRDO 搶份額,CRDO base 同時假設守住份額 — 兩個 base 不可能同時成立)。對每對直接互打的組合:

1. 比對兩邊 base case 的份額 / TAM 假設是否互斥
2. 互斥 → 必須裁決:依 §A.3 的份額方向證據判定哪邊的假設較可信,砍另一邊的數字(調降其 base EPS CAGR 或 IRR),並在此段明寫裁決邏輯
3. 裁決後的數字才能進 §B / §C — 禁止把互斥的兩個 IRR 並排當作都成立
4. 無互斥(市場夠大 / 搶的是第三方份額)→ 明寫「base case 相容,共同假設是 X」

段後必含一段「競爭態勢裁決」box(callout-warn),內容:

• 誰在搶份額、誰在失血(點名具體 evidence,不是重複箭頭)
• 每檔的競爭壓力主要來自圈內還是圈外(圈內第一名若正被圈外對手吃掉,圈內排序沒有意義 — 必須戳破)
• 5 年後這個比較圈的競爭結構最可能變成什麼樣(1-2 句 scenario)

來源紀律:份額數字 / win-loss 案例優先取 v13/v14 DD §7(二維 + QC-23)+ §9 議價權/利潤池(legacy 舊 §9+§11 / DCA Phase A1/A2);報告未載的份額與近期 win/loss,WebSearch 補 1-2 輪並標 webfill。禁止用「競爭激烈」「龍頭地位穩固」這種口號充數 — 每個判斷要有案例或數字。

§B 短中長超長四層獨立打分

四個獨立小節,每層獨立評估、獨立給排序:

• §B.1 <12M 短期:Pure MA + EPS revision + 最近催化
• §B.2 2-3Y 中期:拐點催化 + 估值修復 + PE re-rate
• §B.3 3-5Y 中長期:護城河來源解剖(深) + TAM + EPS 兌現 + IRR 質感(兩段式 — v1.5 強制)
• §B.4 5-10Y 長期:Runway post-Y5 + 範式風險 + 第二曲線

每層必須:

• 列出該時間框架最關鍵的 3-5 個維度
• 三檔(2-5 檔)横向對比表
• 給出該層的排序(第一 / 第二 / 第三)
• 一段「為什麼這個排序」的判斷邏輯(不是堆疊數字)
• 引用 §A.2 / §A.3 的具體格子當論據(例:§B.2 估值修復論點要引 §A.2 表 2 的 margin 展望 row;§B.3 排序要引 §A.3 的份額方向與二維合成)— 引結論不重抄表格;§B 的打分若與 §A.2/§A.3 的體質裁決 / 競爭態勢裁決矛盾,必須在該層明文解釋為什麼(時間框架不同造成的合理分歧 vs 真矛盾)

§B.3 兩段式架構(v1.7 瘦身版 — 防護城河三重寫)

護城河在 v1.6 後出現在三處:§A.1(mechanism row)、§A.3(二維拆解表)、§B.3.a。分工必須明確,禁止重抄:

• §A.1 負責「mechanism 是什麼」(靜態描述)
• §A.3 負責「打得怎麼樣」(二維評分 + 份額戰況)
• §B.3.a 只負責「撐不撐得過 3-5 年」(時間持續性判斷)

§B.3.a 護城河 3-5Y 持續性判斷(必含,引用式)

逐檔寫一段 60-120 字,只回答兩個問題(mechanism 描述用「見 §A.1」一筆帶過,不重抄):

1. 這個 mechanism 為什麼能撐 3-5 年?(時間因素:認證年限 / 設計週期 / 客戶切換成本 / 良率學習曲線斜率 — 必須有時間軸的因果鏈,如「ASIL D 從新 OEM 評估到投產要 5-7 年,所以 2030 前歐美 Top 5 OEM 不會切換」)
2. 3-5 年內最可能讓 mechanism 失效的單一事件是什麼?(對齊 §5 Single Thing)

§B.3.b 排序判斷(必含)

承接 §B.3.a + §A.3 二維合成,給排序 + 判斷邏輯。原本的 IRR 表 / Pattern Match 表保留在這段(IRR 數字 = §C 同源、價格重抓後為重算版)。

§C IRR Composition 質感對比(縱深層)

這是 3-5Y view 真正的 alpha 所在,必須獨立成章:

• 各檔的 EPS 複利 / PE re-rate / 股息+回購 拆解
• 強調「靠自己跑」vs「靠市場配合」的差別
• 拆解 Base IRR 的依賴假設(單變數 vs 多變數)
• 可證偽性比較

§D Bear Case + Max DD 路徑對比

• 各檔的 §5 Single Thing
• Bear 觸發機率與時間軸
• Max DD 評級對比
• 觸發後復原時間
• 誰的 Bear case 是「執行風險」(可控可監測),誰是「範式風險」(模糊不可控)

§E 最終裁決

• 首選變化矩陣(v1.7 — 取代完整排序矩陣):不重抄 §A 的四層排序卡,只標「哪幾層首選不同 + 為什麼換人」。完整排序以 §A 卡片為唯一出處。
• 共同 beta vs 相對 alpha(v1.7 新增,同產業對比強制):引第 4d 步讀到的 ID §0 結論,明確切分 — 「這些是 N 檔共同承擔的產業風險(產業週期翻轉時一起跌,比較不解決,該不該曝險這個產業要看 ID / 跑 industry-thesis-critic)」vs「這些是檔與檔的相對差異(比較才有意義)」。無對應 ID 時自建共同風險判斷並標明。
• 用戶問題重新審視:用戶問的是「3-5Y view 對嗎?」、「能不能拉長到 10Y?」
• 推薦標的明確點名 + 不選其他的具體理由
• 進場條件與監測指標(若有 Pure MA ❌ 等限制)
• 裁決證偽條件(v1.7 新增,強制):1-3 條「若 X 發生,本對比結論作廢、需重跑」— 對齊 DD §13 證偽文化。每條要可監測(數字閾值 / 具體事件),例:「若 CRDO 下季 AEC 營收 QoQ 轉負 → ALAB 首選裁決作廢」「若任一檔之後的財報觸發重大漂移 → 重跑」。供 position-thesis-monitor 之後掃描。
• 一句話 takeaway

【強制原則】

1. 必須給出明確排序

每層時間框架都必須給出 1, 2, 3 名(或 1-N 名)。禁止「並列第一」、「難以區分」、「視情況而定」。

若真的接近,需:

• 說明「接近的具體幅度」(IRR 差 0.5%、護城河差 0.5 分)
• 給出 tiebreaker 邏輯(用什麼第二維度打破平手)

2. 必須點名不選的具體理由

§E 最終裁決必須包含「為什麼不選 [其他每一檔]」段落。 範例:「不選 NOW 是因為:① 22.6% IRR 中 4.4% 來自 PE re-rate,賭市場配合不是 alpha;② 護城河 ↓ narrowing 是三檔中唯一在窄化的;③ MA 距離最遠(-47% 離 W104)」

3. 必須區分執行風險 vs 範式風險

§D 必須明確判斷每檔 Bear case 屬於哪一類:

• 執行風險(可監測、可證偽):margin path、NPL、新產品上線、投資週期結束 — 1-2 季可看出
• 範式風險(模糊、5-10 年才能 settle):AI agent 取代、平台被解構、產業結構重塑 — 中途有很多 ambiguous moment

範式風險檔案在 5-10Y view 下不利,因為持有期間會有持續焦慮。

4. 必須對齊用戶問題

如果用戶問「3-5 年視角」,§E 必須明確答 3-5 年 view 的結論。 如果用戶問「短期 + 中期混合」,§E 必須區分兩層分別的答案。

5. 禁止 IRR composition 偷懶

§C 必須拆 EPS 複利 / PE re-rate / 股息回購 三項。 禁止只說「Base IRR 12%」就帶過 — 必須說「12% 中,EPS 22% - PE re-rate -9% + buyback 0% = 12%」。

這是這個 skill 的核心差異化 — 多數對比工具只看 IRR 數字,不看質感。

6. Pattern Match 強制引用

v13/v14 DD §11.7 Pattern Match(legacy DCA §4)若有,§B.3 中長期排序時必須引用。 範例:「MELI Pattern Match = Amazon 2014-2019(主動投資週期),已驗證 5Y +417%」→ 比 NOW 的 CRM 2022 + ADBE 2024 雙重 pattern(估值修復為主、EPS 平淡)更乾淨。

7. 時間軸切換敏感度測試

§E 必須明確標示:「若時間軸從 X 拉到 Y,首選會變嗎?」 範例:「3-5Y 首選 MELI,但若拉到 5-10Y 首選變 SE(雙 secular tailwind + 10Y IRR 17.5% 最高)」。

這就是用戶上一輪對話中發現的核心洞察 — 排序本身對時間軸敏感,這是真正的 alpha。

8. 基本面格子必須是 sourced number(v1.6)

§A.2 四張表的每一格必須是具體數字 + 來源可追(v13/v14 DD 章節 / dd-meta,或 WebSearch webfill 標註)。禁止「高 / 中等 / 不錯 / 健康」這類定性詞充數。報告未載 → 標「n/a(來源未載)」,不准瞎掰;但 ROIC / FCF margin / NRR 三個關鍵格缺值時必須先 WebSearch 補 1 輪。同一數字跨章節(§A.2 vs §C vs §B)必須一致 — EPS CAGR 在 §A.2 表 1 與 §C IRR 拆解用的是同一個數,不一致就是 bug。

9. 競爭對比不准關起門來打(v1.6)

§A.3 必須包含「圈外最大威脅」column — 只在圈內排序會產生假安全感(四檔都在被圈外第五家吃掉時,圈內第一名沒有意義)。每檔至少點名 1 個圈外對手 + QC-23 威脅等級;head-to-head 段每對組合都要有 win/loss 案例或明寫「無直接重疊」。競爭判斷禁止口號(「競爭激烈」「龍頭穩固」),每個判斷要有案例或數字背書。

10. 互斥的 base case 不准並排當作都成立(v1.7)

直接競爭的兩檔,base case 可能重複計算同一塊份額(A 假設搶、B 假設守)。§A.3 互斥假設檢查裁決完之前,兩邊的 EPS CAGR / IRR 不得進 §B / §C 並排比較。裁決必留痕(依據哪個份額證據、砍了哪邊多少)。

11. 混合 vintage(v13/v14 DD + legacy)的公平性(v1.8 改寫)

v1.8 起所有檔預設都是 v13/v14 DD（IRR composition / Pattern Match / Max DD / 統一裁決齊備），同 vintage 時不存在「資料多寡」不公平。只有當部分檔是 legacy（舊 DCA/v12 DD）而缺某維度（如舊 v12 DD 無 §11.6 三分量、舊 DCA 無 §9.F 逐段 TAM）時:(a) webfill 補齊,或 (b) 該維度從排序依據中剔除(仍可呈現但標「僅供參考,非排序依據」)。禁止拿「v13/v14 檔有、legacy 檔沒有」的維度當 tiebreaker。新舊 vintage 差異一律在 §A 報告 vintage 表標明。

12. 不引入機械加權評分(v1.7 — 反向原則)

禁止為了「看起來客觀」加權重打分表(權重本身沒有依據,是偽精確)。排序靠敘事判斷 + 明確 tiebreaker(原則 1),數字當論據不當公式。

【寫稿後 self-review gate】(v1.7 新增 — 強制,過 gate 才能寫 index.html)

HTML 寫完後、更新 docs/comparisons/index.html 之前,執行以下檢查。任一項 fail → 先修正 HTML 再過 gate,不准帶傷上 listing:

數字回查(抽查制):

1. 隨機抽 ≥6 個關鍵數字(每檔至少 1 個;優先抽 EPS CAGR、IRR、市占 %、ROIC),回開 source 報告(或 latest.json / webfill 來源)逐一核對 — 數字、單位、FY 區間都要對得上
2. 抽到對不上 → 全章節同類數字全面複查,不是只修被抽到的那格

跨章節一致性: 3. §A.2 表 1 EPS 5Y CAGR = §C IRR 拆解用的 EPS 複利假設(同源同值) 4. §A.1 客戶集中度 row = §A.2 表 4 客戶經濟性數字(只引不抄,但值一致) 5. 價格重抓檔:§A 現價、Fwd PE、§C 重算後 IRR、§E 進場觸發狀態四處用同一個新價 6. §B 各層排序與該層論據無自相矛盾;§E 不選理由與 §B 各層結論不矛盾(若某檔在某層第一但 §E 不選,理由必須講清楚是時間框架取捨)

流程完備性: 7. 財報 staleness gate 每檔都跑過,vintage 表填齊;重大漂移檔的警語在 verdict card 上 8. 互斥假設檢查:每對直接競爭組合都有「相容 / 互斥+裁決」結論 9. §E 裁決證偽條件 ≥1 條且可監測(有數字閾值或具體事件) 10. HTML size ≥ floor(2 檔 45K / 3 檔 60K / 4-5 檔 70K),且非灌水達標 11. HTML_TEMPLATE.md 完成檢核 15 條全過

可選 cold-review sub-agent(用戶要求「嚴格一點 / 跑 critic」時):spawn general-purpose sub-agent(sonnet),給它 source 報告路徑 + 產出 HTML,只驗兩件事 — 數字 vs source 一致性、排序邏輯內部一致性。發現大錯回報修正,cosmetic 忽略。

【HTML 輸出協議】

視覺規格(對齊 InvestMQuest research.investmquest.com 風格)

CSS 規格詳見 HTML_TEMPLATE.md。核心要點:

• 背景:#ffffff(白底)
• 主文字:#1a1d24
• 強調:#000000(粗體)
• 強調色:藍 #1565c0、橘 #c2410c、綠 #15803d、紅 #991b1b
• 表格邊框:#d0d8e0
• 字型:-apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang TC", "Microsoft JhengHei", Roboto, sans-serif
• 章節錨點:#sA、#sA1、#sA2、#sA3、#sB1、#sB2、#sB3、#sB4、#sC、#sD、#sE
• 頂部導航:固定 sticky,提供快速跳轉
• 手機優化:@media (max-width: 768px) 內字級放大、padding 縮小

訊號燈規範

四種主要訊號燈(對齊 v13/v14 DD):

• 🟢 高確信 / 寬 / 便宜
• 🟡 中性 / 中等 / 觀察期
• 🔴 警示 / 窄 / 昂貴
• ⚫ X(迴避)

排序視覺:

• 🥇 第一名(綠底)
• 🥈 第二名(灰底)
• 🥉 第三名(橘底)
• (4 檔以上續用數字)

結論卡片格式

§A Dashboard 頂部必須有「綜合裁決卡片」:

推薦標的:[Ticker]
適用時間框架:3-5 年
主要理由(三條):
1. [一行]
2. [一行]
3. [一行]
進場條件:[Pure MA 確認 / 拐點催化 / 等等]

【資料時效性協議】(v1.7 — 從 v1.3 股價協議擴充為四段)

1. 股價重抓觸發條件

skill 讀完報告後,立即計算「報告寫稿日距今天數」:

唯一股價來源:WebSearch(Yahoo Finance / Bloomberg / TradingView 等)。台股 / 日股 ticker 轉 yfinance 格式查詢:2330TW → 2330.TW、6857T → 6857.T、0700HK → 0700.HK。

2. 重抓的執行步驟(含 IRR cascade — v1.7 修正)

對每一檔(若觸發):

1. 抓最新股價
2. 重算:Fwd PE = 新價 / FY+1 EPS;PEG = 新 PE / EPS growth(EPS 優先取 DD_SCREENER_JSON 同源數字)
3. 重算 §C IRR re-rate 段(強制):用報告的 exit 假設(目標價 / exit PE / FY+5 EPS)+ 新價重算 re-rate 段與總 IRR。報告價算的 IRR 在價格漂移後是錯的,禁止照抄。EPS 複利段與股息回購段沿用報告假設(與進場價無關)。
4. 重新評估進場條件觸發狀態:報告中的價位閾值(如「跌至 $185 加碼」)是否已觸發
5. MA50 / MA200 / RSI / Bollinger 沿用報告日數據(需歷史每日序列才能重算)

3. 財報 staleness gate(v1.7 新增 — 強制,不受「不要重抓」覆蓋)

對每檔執行:

1. WebSearch "{ticker} latest earnings date" 確認報告日之後是否有財報發布
2. 沒有 → 該檔標 vintage: 報告日,之後無新財報 即可
3. 有 → 再 WebSearch 該季結果(EPS/rev vs consensus、guidance 變化、盤後反應),做假設漂移比對:
   • 輕微(in-line,guidance 維持)→ report-meta 標「之後有 X 季財報,結果大致符合報告假設」,§B 引用時口頭吸收
   • 重大(guidance 砍 / miss / thesis 級事件如大客戶流失、競爭格局劇變)→ §A verdict card 加警語(該檔評估基於已漂移的舊報告 + 本次 webfill 校正)、§B 各層該檔打分必須吃進新資訊、§E 若仍推薦該檔須說明為何漂移不傷 thesis
4. 漂移比對結果寫進 §A 的「報告 vintage 表」(每檔 1 row:報告 schema(v13/v14 / legacy) / 報告日 / 之後財報? / 漂移判定)

4. as-of 標註規則(v1.7 — 取代 v1.3 純無痕規則)

呈現仍然乾淨:不加 banner、不顯示校正前後對比、不標漂移百分比,最新股價直接填入 §A Dashboard。 但 report-meta 必須有一行 as-of 標註:股價 as-of YYYY-MM-DD(WebSearch)· 技術指標 as-of 各報告日 · EPS consensus as-of {latest.json snapshot 日}。無聲混用兩個時點的資料對準確性是負債 — 乾淨呈現可以,隱瞞 vintage 不行。

【輸入處理協議】

接收的輸入類型

skill 支援三種輸入方式,自動判別:

方式 A:給 ticker(最常用,Claude Code 主要場景)

用戶說「比較 2330 / NVDA / AVGO」或「比較 NVDA / AVGO 看定見」

skill 行為:

1. ls docs/dd/ 找每檔最新的 DD（v1.8 DD-first）
2. read_file 讀取(優先 dd-meta JSON 取結構化值)
3. 只有某檔完全找不到任何 DD 才走「缺漏處理」流程；legacy ticker 直接走 legacy 抽取

方式 B:給 ticker 不指明任何來源(最常見)

用戶說「比較 NVDA / AVGO」

skill 預設行為:

• 直接讀每檔最新 v13/v14 DD(已含決策層;不問來源)
• 某檔若是 legacy → 走 legacy 抽取 + vintage 表標註

方式 C:明確指定日期

用戶說「比較 2330 / NVDA 用 5/7 那批」

skill 行為:

• ls 帶日期 pattern:DD_2330TW_20260507.html
• 若指定日期不存在 → 列出最接近的日期讓用戶選

Ticker 命名規則

【環境整合說明】(financial-analysis-bot 環境鎖定)

Repo / 相關 skill 對應

本 skill 是消費端 — 假設目標 ticker 的 v13/v14 DD 已存在。若用戶要的 ticker 還沒有任何 DD,不自動觸發 stock-analyst,先告知用戶並提供選項（換 ticker 或先去跑 stock-analyst DD）。

Pre-commit hook

scripts/hooks/pre-commit 目前只 validate docs/dd/DD_*.html 與 docs/id/ID_*.html。docs/comparisons/MS_*.html 不在 validator 範圍(無 dd-meta JSON 強制 schema,與個股 DD 不同)。

Listing 同步

每次產出後,必須 insert 一個 <li> 卡片到 docs/comparisons/index.html 的 <ul class="reports"> 最上方(見第七步)。listing 頁是手動 / skill-appended 維護,沒有 build script。

Nav

/comparisons/ 已加入首頁 docs/index.html 的「研究」dropdown。其他 top-level 頁(/research/、/earnings/ 等)若使用者要求,再做 nav 同步 sweep。

【版本歷史】

• v1.8-cc-tuned(2026-06-27):DD-first 來源切換 — DCA 已於 2026-06-22 併入 stock-analyst v13/v14 單一報告,本 skill 主要資料來源從「優先 DCA / DD fallback」翻轉為「預設讀每檔最新 v13/v14 DD;DCA + 舊 v12 DD 降為 legacy fallback,只在某 ticker 無 v13/v14 DD 時使用」。改動:① frontmatter description + §模式說明 + 第一步/第二步 + 情境處理表全部 DD-first,不再問「要 DCA 還是 DD」,用戶說「用 DCA / 看定見」也讀同一份 v13/v14 DD,禁報「DCA 缺」;② 缺漏處理改為「只有完全找不到任何 DD 才停下詢問,legacy ticker 直接走 legacy 抽取」;③ 數據抽取對照表重構為「v13/v14 DD 抽取自(主要)」+「legacy 抽取自(fallback)」雙欄,第 2 欄改用 v13 −2 位移後的正確章節編號(護城河 §7、估值 §11、IRR §11.5/§11.6、Pattern Match §11.7、Max DD §13c、統一裁決 §14、Single Thing §3.F、議價權 §9、客戶結構 §6.H、成長品質 §6.B、附錄 A 擇時、附錄 B 循環),並優先讀 dd-meta JSON 取結構化值(dca_verdict/ev5y_pct/irr_base_pct/max_dd_pct/moat_trend/runway_post_y5/val/peg_fy2);④ 原則 #11 從「DCA vs DD 資料多寡公平性」改為「v13/v14 vs legacy vintage 公平性」;⑤ skill 對應表標明 deep-conviction-analyst 已退役;⑥ size floor / 訊號燈 / 輸入範例文字同步去 DCA-default。骨架(§A/§B/§C/§D/§E 四層時間框架 + 四表 + 競爭態勢 + self-review gate)維持不動。
• v1.7-cc-tuned(2026-06-11):準確性大修 — 修「輸入資料時效與跨報告可比性」的結構性漏洞。新增:① 財報 staleness gate(每檔查報告日後是否有財報,漂移分輕微/重大,§A 加報告 vintage 表,重大漂移上 verdict card 警語);② 估值同源正規化(docs/dd-screener/latest.json 統一 Koyfin consensus 為 §A.2/§A Fwd PE 優先來源,混源標 footnote);③ IRR cascade(價格重抓必連 §C re-rate 段用新價重算,修 v1.2 只重算 PE/PEG 的 bug);④ 互斥假設檢查(直接競爭組合的 base case 重複計算份額時必裁決,裁決後才進 §B/§C — 原則 #10);⑤ 寫稿後 self-review gate(數字抽查 ≥6 + 跨章節一致 + 流程完備 11 條,過 gate 才上 index;可選 cold-review sub-agent);⑥ §E 裁決證偽條件(≥1 條可監測,供 position-thesis-monitor 掃);⑦ §E 共同 beta vs 相對 alpha 段(同產業對比強制引 ID §0);⑧ 原則 #11 混合來源公平性(單邊有資料的維度不得當排序依據)。減少 / 修正:⑨ §B.3.a 瘦身為引用式 60-120 字(mechanism 描述歸 §A.1/§A.3,防護城河三重寫);⑩ §E 完整排序矩陣改「首選變化矩陣」(完整排序唯一出處 = §A 卡片);⑪ v1.3 無痕呈現軟化 — 呈現照舊乾淨但 report-meta 強制 as-of 行(股價/技術指標/EPS consensus 三個 vintage);⑫ 原則 #12 明文禁止機械加權評分(反偽精確)。另:Pure MA 維度加定位註記(DD timing 訊號,非 six-state ETF-only 部位指令)。
• v1.6-cc-tuned(2026-06-11):基本面 + 競爭面對比全面加深 — 用戶 feedback「基本面和競爭面的對比要更詳盡」。新增兩個強制章節:§A.2 基本面財務體質對比(四張表:成長引擎含價/量質量拆解、獲利結構含 ROIC vs WACC 與 margin 3Y 方向、資產負債與資本配置含 SBC/buyback/capex intensity、經營質量含 NRR/guidance 兌現/earnings quality;表後各 1 段橫向洞察 + 財務體質裁決 box;每格 sourced number 禁定性詞);§A.3 競爭態勢對比(主戰場競爭格局含份額 3Y 方向 + 圈外最大威脅、護城河二維拆解對齊 DD v12.3 §9、議價權三段對齊 §11、head-to-head 逐對 win/loss 證據、競爭態勢裁決 box)。§B 各層強制引用 §A.2/§A.3 格子當論據且矛盾必須解釋。強制原則新增 #8 sourced number 紀律、#9 圈外威脅必點名。新增 size floor:2 檔 ≥ 45KB / 3 檔 ≥ 60KB / 4-5 檔 ≥ 70KB。抽取對照表補 7 rows(成長質量 / 客戶結構 / 二維護城河 / QC-23 / 議價權三段 / 資本配置 / guidance 紀錄)+ 舊版報告缺欄位的推導 fallback 規則。
• v1.5-cc-tuned(2026-05-26):補強 skill 結構性缺口 — 用戶 feedback「基本面 / 業務面 / 競爭態勢 / 護城河說明過少」。新增 §A.1 業務地圖 + 護城河來源對照(6 rows × N 檔,強制章節 — 營收 mix、主要產品線、客戶集中度、直接對打 socket、護城河 mechanism、護城河趨勢來源)+ box-alpha 業務地圖洞察;§B.3 拆成兩段式(§B.3.a 護城河來源解剖每檔 100-200 字 mechanism 級判斷,禁止口號;§B.3.b 排序判斷承接 a 段),解決 v1.4 將護城河壓縮成「評分 + 趨勢箭頭」一格的問題。骨架其他章節維持不動。
• v1.4-cc-tuned(2026-05-13):在 Claude Code (financial-analysis-bot) 環境完成 fine-tune — 環境常數鎖定為 docs/dca/ / docs/dd/ / docs/comparisons/ / .html;股價來源固定走 WebSearch(fetch_prices.py 為 batch job 不適用 ad-hoc);git flow 為手動 add / commit / push,未啟用 push-comparisons skill;新增第七步「append 到 docs/comparisons/index.html」。「環境參數待確認」段刪除。
• v1.4-cc(2026-05-13):Claude Code 環境專用版本。第一步改為 ls 本地 dca/ / dd/ 目錄(取代 v1.4 的 web_fetch INDEX_URL)。直接 read_file 本地 markdown(取代 web_fetch report URL)。輸出至 docs/comparisons/ 而非 /mnt/user-data/outputs/,可直接 git push 上線。新增「環境參數待確認」段,部署時需與本地 Claude 確認真實路徑/檔名/git 流程。
• v1.4(2026-05-13):加入 INDEX_URL 強制第一步協議,解決 Claude.ai 環境 web_fetch 權限限制。但發現 INDEX 頁更新頻率 ≠ DCA 產生頻率,導致新 DCA 仍可能 fetch 失敗(LITE/COHR/FN 案例)。本問題在 cc 版徹底解決(直接讀本地檔)。
• v1.3(2026-05-13):股價校正改為「無痕呈現」 — 不再顯示「校正前/校正後對比」、不加 banner、不標漂移百分比。
• v1.2(2026-05-13):加入股價時效性協議。報告日 > 3 天自動 web_search 最新股價並重算 Fwd PE / PEG。
• v1.1(2026-05-13):配色翻轉成白底深字。加入「從 ticker 自動找 URL」協議。
• v1.0(2026-05-13):Inception 版本。