| name | invest-committee |
| description | 散戶自用的機構級個股研究流程（投資委員會）。融合基本面成長品質、機構觀點共識、資金籌碼技術擇時、風險雷達四大分析與完整行動計畫產出，支援台股/美股/港股/A股依代碼自動路由。當用戶要求分析個股（「幫我分析台積電」「深度分析 NVDA」「看 0700 港股」「分析 A股 600519」）、開投資委員會、健檢自選股、掃描個股風險、看技術面、比較兩檔股票、看某檔台股當沖／當沖劇本／比較兩檔當沖（「力成當沖」「6239 當沖劇本」）時使用。 |
invest-committee（投資委員會）
像機構一樣研究個股：六階段管線產出含部位建議的行動計畫。僅供研究參考，不執行任何下單。輸出繁體中文。
🔴 紅線黑名單（絕不做 — 每次輸出前逐條自檢）
- 🚫 不編造數值：任何價格／財報／籌碼數字必須有來源；查無 → 標「未獲取」，嚴禁用「較高／大概／約」搪塞或憑記憶填數。
- 🚫 不下單、不代做買賣決策：本 skill 只做研究，絕不呼叫任何下單／交易 API；行動計畫一律附「僅供研究參考，非投資建議，下單與盈虧自負」。
- 🚫 不猜代碼、不猜市場：查無個股或市場判定不了 → 請使用者確認，絕不自行替換成相近標的。
- 🚫 指標不心算：技術指標一律取
scripts/indicators.py 輸出；腳本失敗 → 如實回報，絕不心算或估算補值。
- 🚫 不整段照抄研報／新聞：改寫總結並標出處，不原文搬運。
- 🚫 不隱藏資料缺口：來源退級、資料過期、K線不足一律在報告中明講，不粉飾成完整結論。
§1 模式判定（先做）
| 模式 | 觸發例 | 行為 |
|---|
| 單股深度 | 「幫我分析台積電」「開投資委員會看 NVDA」 | 跑完整六階段 → 完整版報告＋dashboard |
| 單環節 | 「看 NVDA 技術面」「掃 2330 風險」「2330 基本面如何」 | 只跑對應階段（2-5 其一）＋精簡結論，不跑全管線 |
| 自選股健檢 | 「健檢自選股」 | 讀 watchlist 逐檔跑精簡版（風險雷達＋資金技術重大變化）→ 健檢精簡版報告 |
| 個股比較 | 「比較台積電和聯電」 | 兩檔各跑階段 2-5 核心 → 比較版報告 |
| 當沖 | 「力成當沖」「看 2408 當沖」「當沖劇本 6239」「比較力成和南亞科當沖」 | 走當沖管線（見 §8）→ 單股當沖卡或雙股並排＋裁定 |
觸發詞含「當沖／現沖／隔日沖／當沖劇本」→ 當沖模式（限台股）；句含 2 個標的＋「比較／和／vs」→ 雙股當沖。命中當沖詞就走 §8，不進六階段。
市場路由與代碼判定規則：讀 references/data-sources.md §1。判斷不了市場時追問一次，不猜。
題材級問題不歸本 skill：若使用者問的是題材／產業層級的選股問題（如「AI 供應鏈哪檔最值得研究」「台股半導體幫我找標的」——沒有具體代碼），先建議改用 serenity-skill 掃產業鏈卡點、取得優先研究名單，再把名單帶回本 skill 逐檔深度分析或加入 watchlist。本 skill 從「有具體標的」才開始。
§2 前置動作
- 定位資料目錄（依序找，先中先用）：①
~/.invest-committee/ ② 目前工作目錄下的 portfolio/。都不存在 → 用 assets/templates/ 的範本建立 ~/.invest-committee/（含 profile.md、watchlist.md、reports/），提示使用者填寫。
- 讀
<資料目錄>/profile.md（總資金、單一部位上限、風險承受度、預設週期、資料收集模型）。缺檔或缺欄 → 用「上限 10%／承受度中／波段／資料收集模型 haiku」預設並提示。
- 投資週期：任務有指定（短線/波段/長線）用指定值；否則用 profile 預設。
- 健檢模式：讀
<資料目錄>/watchlist.md 逐列處理；表空 → 請使用者先填自選股。
§3 六階段管線
單環節模式只跑對應階段；健檢模式每檔只跑階段 1、4（資金部分）、5。
成本原則（省 token）：階段 1 是純抓取（低推理、大量工具輸出），委派給便宜模型的子 agent 執行，把原始工具輸出留在它的 context；主 session（你跑分析用的較強模型，如 Opus）只收精簡資料包，再做階段 2-6 的判斷。這樣貴模型不被大量 K線／財報／網頁灌爆。
階段 1：快照與資料收集（委派） — 讀 references/data-sources.md。
- 委派抓取：runtime 支援指定子 agent 模型時，spawn 一個「資料收集子 agent」（模型取 profile 的「資料收集模型」，預設 Haiku；該市場需靠網搜判斷來源品質時改用 Sonnet）。交付它：依市場用 ToolSearch 一次批量載入 twstock 工具、取行情／公司基本資料／財務／籌碼、把 K線組成 §5 的 JSON 落地 scratchpad、跑
scripts/indicators.py，只回傳精簡資料包（數值＋來源表＋指標輸出＋「未獲取」缺漏清單），不回傳整段原始工具輸出。
- 子 agent 硬規則：嚴守 §4 與 🔴 紅線黑名單——只回報抓到的值＋來源，缺的標「未獲取」，絕不估算或編造，也不做任何分析判斷（判斷全留給主 session）。主 session 收到資料包後應快掃缺漏清單，關鍵欄位缺太多才補抓。
- 不委派：runtime 不支援指定子 agent 模型，或單環節只查單一數值的輕量請求 → 主 session 直接抓。
- 健檢批次：每檔的資料收集都走便宜子 agent（可並行），主 session 只彙整燈號與重大變化。
階段 2：基本面與成長品質 — 讀 references/stage-fundamental.md。產出固定三行小結。
階段 3：機構觀點與共識 — 讀 references/stage-consensus.md。產出固定三行小結。
階段 4：資金籌碼與技術擇時 — 讀 references/stage-technical.md。先跑 scripts/indicators.py，指標值一律取腳本輸出。產出固定三行小結。
階段 5：風險雷達 — 讀 references/stage-risk.md。四維評分＋燈號，輸出前跑自洽校驗。
階段 6：投資委員會結論 — 讀 references/stage-action.md。Bull/Bear 對辯後依公式產出行動計畫表。
🔴 CHECKPOINT（輸出行動計畫前自檢）：建議部位不得超過 profile 的單一部位上限；超過 → 下修至上限並註明。行動計畫結尾必附「僅供研究參考，非投資建議，下單與盈虧自負」。
§4 資料紀律（強制）
- 所有數值必須有明確來源；缺資料一律標「未獲取」，嚴禁編造或用「較高」「大概」等模糊詞搪塞。
- 網搜取得的資料逐條標註出處（網站名＋日期）。
- 來源失敗自動退到下一優先級，且報告註明退回原因；富途 OpenD 未連線 → 改用免費源並註明。
- 查無個股 → 請使用者確認代碼（含市場、簡稱、全稱），不自行猜測替代。
- 非交易日 → 報告開頭標註「資料截至：YYYY-MM-DD（最近交易日）」。
- 研報/新聞觀點改寫總結，不整段照抄。
§5 輸出
- 報告結構依 references/report-template.md（完整版／健檢精簡版／比較版）。
- 完整版另產 dashboard：依 report-template.md 的「Dashboard 產出流程」，用 assets/dashboard-template.html 替換 token 後輸出（runtime 支援檔案 render 工具如 SendUserFile 就 render；否則存檔到
<資料目錄>/reports/ 並回傳路徑）。
- 排程觸發的健檢：報告另存
<資料目錄>/reports/YYYY-MM-DD.md，並推送燈號總表摘要（runtime 支援推播則推播，否則摘要寫入報告檔開頭）。互動分析不落檔。
§6 錯誤處理（三段式：一線修復 → 仍失敗兜底）
| 觸發條件 | 一線修復 | 仍失敗兜底 |
|---|
| 查無個股 | 請使用者確認代碼（市場＋簡稱＋全稱） | 使用者無法確認 → 終止該股分析，不猜測替代標的 |
| OpenD 未連線 | 退回免費源（Yahoo／網搜）＋報告註明；提示 install-futu-opend skill | 免費源也失敗 → 見下「全來源失敗」列 |
| twstock 工具失敗 | 改用網搜並標註來源與原因 | 網搜也無資料 → 該欄標「未獲取」，不以估值搪塞 |
| 全來源失敗（某數據所有來源都拿不到） | 換下一優先級來源逐一嘗試 | 全數失敗 → 該區塊標「未獲取」，報告開頭列出缺漏清單，不生成該區塊的結論 |
| K線不足（新上市） | 用可得天數計算，長週期指標標「未獲取（資料不足）」 | 天數 < 最短指標窗 → 技術面整段標「資料不足，暫不評分」 |
| indicators.py 執行失敗 | 如實回報錯誤，不改用心算補數值 | 重試仍失敗 → 階段 4 技術擇時標「未計算」，行動計畫註明「缺技術面輸入」 |
| dashboard 產出失敗（模板/render） | 重試一次；仍失敗改附純文字報告 | 一律先交付文字報告，dashboard 缺失在結尾註明，不因視覺產物失敗而卡住整份輸出 |
§7 資源索引
§8 當沖管線（限台股）
當沖模式不進六階段，跑以下聚焦管線。口徑與規則讀 references/stage-daytrading.md。
- 資料收集（委派便宜模型，同 §3 階段 1）：日K ≥60、當日＋近 5 日三大法人、成交量/值、月營收 YoY、PE/PB、當沖適性 gate 三項；有 watchlist 持倉時取成本。指標一律取
indicators.py（含 amplitude_5_pct 5 日均振幅）。
- 🔴 當沖適性 Gate（stage-daytrading §1）：查當日沖銷名單／暫停當沖預告／處置股。不可（或受限）當沖 → 頂部警示、只給觀察、不出進出場劇本。
- 波動與流動性（ATR%／5日均振幅／量比／成交值；量縮→非好獵場）。
- 技術決戰帶（indicators.py 的支撐壓力＋缺口 → 標多空分界價區）。
- 當日籌碼（當日三大法人方向與近 5 日連續性）。
- 五維雷達（沿用，當沖語境技術/資金/波動優先）。
- 當沖劇本（多空各一：觸發→目標→日內停損 ≤0.5×ATR；做劇本不做信仰）＋部位集中度警示（讀 profile＋watchlist）。
輸出：單股當沖卡或雙股並排＋委員會裁定，用 assets/daytrading-dashboard.html（台股紅漲綠跌），存 <資料目錄>/reports/daytrading_<代碼>_<日期>.html。能力邊界聲明必附（日K-based，不含分時/五檔，要 tick 接富途）。
