| name | ai-stock-report-generator |
| description | 台股「一鍵財務模型 + 投資簡報」生成器。使用者輸入任何台股代號（如 6116、2330、0050）並加上 //ai-stock-report-generator，或沿用舊觸發詞 //model-up，或說「建立財務模型」「Excel 財務模型」「估值模型」「幫我做 XXXX 的估值和簡報」「XXXX 財務模型整理成 PPT」「model up XXXX / ai stock report XXXX」時，必須立即使用此技能。技能會即時搜尋最新公開財務數據與近期日線資料，產出核心檔案：(1) 完整 Excel 財務模型（假設可調、三情境預測、P/B 與 P/S 估值、敏感度表、財務指標、KD/MACD 技術指標、K 線型態資料、風險矩陣，全部以公式或可稽核計算連動、零公式錯誤）；(2) 投資分析 PPTX（有數據、有圖表：歷史財務、營運動能、成長動能、估值、KD/MACD、K 線型態、風險、結論）；必要時另附可下載的 K 線 HTML/PNG 圖表。即使使用者只丟出「代號 //ai-stock-report-generator」也必須執行完整流程，不得僅用文字回覆。 |
ai-stock-report-generator：台股財務模型 + 投資簡報生成器
輸入：台股代號（4-6 位數字）。核心輸出：{代號}_{名稱}_財務模型.xlsx + {代號}_{名稱}_投資分析簡報.pptx。若已產生 K 線型態圖，另輸出 {代號}_{名稱}_K線型態圖表.html 與 {代號}_{名稱}_K線型態圖表.png。全部存至 /mnt/user-data/outputs/ 或當前專案 outputs/，並以 present_files 或本機連結交付。
執行前必讀：本技能依賴內建 xlsx 與 pptx 技能的規範。開工前先閱讀：
/mnt/skills/public/xlsx/SKILL.md（色碼規範、recalc.py 驗證）/mnt/skills/public/pptx/SKILL.md 與 pptxgenjs.md（設計規範、視覺 QA）
流程總覽
代號 → ①資料蒐集(web_search + 日線資料) → ②Excel模型(財務 + 技術指標) → ③K線型態圖(HTML/PNG) → ④PPTX(財務 + 技術圖表 + QA) → ⑤交付
第 1 步：資料蒐集（web_search，3-5 次搜尋）
必須即時搜尋，不可依賴訓練記憶。建議查詢組合（{N}=代號、{名}=公司名）：
{N} {名} 全年財報 EPS 營收 — 近三年年度營收、EPS{名} {N} 股價 今日 每股淨值 — 最新收盤價、股淨比/每股淨值{名} {N} 股價 大漲/展望 產業 — 題材、成長動能、法人觀點- （選配）
{N} 財報分析 季度 — 最新季度損益細節（營業利益率、ROE/ROA、FCF、現金轉換循環）
必蒐集清單（缺項時以已知數據回推並明確標注「估計」）：
- 最新收盤股價與日期、股本/股數、市值
- 近 3 年：營收、EPS、（可得則加 ROE/ROA/FCF）
- 近 5 季：季度 EPS
- 今年月營收與年增率、累計營收
- 每股淨值（BVPS）；虧損股沒有本益比時改以股淨比推算
- 成長題材與 3-7 項具體風險（含觀察指標）
資料誠信規則：
- 每個硬編碼數字都要在 Excel 備註欄標注來源與日期（格式：
來源: {網站}, {日期}）
- 推算值（如以年增率回推前一年營收）必須註明推算方式
- 引用新聞觀點以改寫轉述，勿逐字複製
第 1.5 步：近期技術資料與 K 線型態資料
必須補抓近期日線資料，至少 60 個交易日；若交易所 API 無法一次取得足夠資料，要按月份回補。台股優先使用 TWSE / TPEx 官方日成交資訊。
技術資料至少包含：
- 日期、開盤、最高、最低、收盤、成交量
- MA5、MA10、MA20
- BB(20,2)：中軌、上軌、下軌
- KD：RSV(9)、K(9,3)、D(9,3)，K/D 初始值可用 50，但須註明
- MACD：EMA12、EMA26、DIF、MACD/Signal(9)、柱狀體
台股圖表色彩硬性規範：
- 台灣股票圖表必須使用台股慣例：紅色 = 上漲 / 正值 / 偏多，綠色 = 下跌 / 負值 / 偏空。
- K 線實體、影線、成交量柱必須紅漲綠跌；不得使用美股常見的綠漲紅跌。
- MACD 柱狀體必須正柱紅色、負柱綠色；若使用連續線替代柱狀圖，仍須另提供紅/綠柱狀圖或明確色彩標示。
- KD 線本身可用固定配色，但旁邊的多空/訊號標記仍須遵守紅多綠空。
K 線型態標記至少包含可規則化判斷的項目：
- 布林通道突破或跌破
- 局部高點 / 局部低點
- 跳空缺口
- 十字線或長影線
- 均線黃金交叉 / 死亡交叉
若使用規則式偵測，必須標註「型態標記為規則式偵測，適合教學與快速觀察，不等同投資建議」。不要把型態標記描述成保證訊號。
第 2 步：Excel 財務模型（openpyxl）
工作表結構（至少 8 表，繁體中文命名；可依工具限制使用英文表名但要清楚可讀）：
| 工作表 | 內容 |
|---|
| 總覽 | Dashboard：市場快照、基準情境摘要、核心觀點（全部綠字跨表連結） |
| 假設 | 基礎輸入 + 三情境（保守/基準/樂觀）成長率與利益率 + 估值假設。藍字輸入、黃底關鍵假設 |
| 歷史財務 | 年度損益、季度 EPS、最新季損益摘要、月營收（藍字硬編碼 + 來源備註） |
| 預測 | 三情境 2026E-2028E：營收→營業利益→業外→稅前→稅後→EPS，全公式引用「假設」表 |
| 估值 | 現況(P/B、P/S) + DCF 簡化估值 + 相對估值 + 情境目標價 + 敏感度表（P/B × BVPS 交叉，公式如 =$A24*B$23） |
| 技術指標 / Technical | 近期日線、MA5/10/20、BB(20,2)、KD、MACD、成交量與技術圖表 |
| 風險分析 | 風險矩陣：機率×衝擊(1-5分)，風險值用公式 =C{r}*D{r}，附觀察指標 |
| 來源 / Sources | 財務資料、股價資料、日線資料與新聞/法說來源 URL |
硬性規範（承襲 xlsx 技能）：
- 藍字
0000FF=輸入、黑字=公式、綠字 008000=跨表連結、黃底=關鍵假設
- 所有計算用 Excel 公式，禁止 Python 算好硬編碼；稅負用
=稅前-MAX(0,稅前)*稅率 處理虧損年度
- 負數格式
#,##0.0;(#,##0.0);"-"、百分比 0.0%、倍數 0.00"x"、年度為文字
- 存檔後必跑
python /mnt/skills/public/xlsx/scripts/recalc.py {檔案} 60，必須 total_errors: 0
- 用
data_only=True 重讀抽查總覽/估值關鍵值是否合理（市值=股價×股數、P/B=股價/BVPS）
- 技術指標表必須能追溯到日線資料；若另做 K 線 HTML/PNG，Excel Sources 表也要列出日線來源
估值方法選擇：虧損股以 P/B 為主軸 + P/S 交叉驗證；獲利股加入 P/E 情境。目標倍數區間參考該產業歷史常態並於假設表說明。
第 3 步：PPTX 投資簡報（pptxgenjs）
至少 14 頁架構、LAYOUT_16x9、中文字型 Microsoft JhengHei、配色 Midnight Executive（navy 1E2761 / ice CADCFC / gold C9A227，深色封面與結論夾淺色內容）：
- 封面 — 代號大字(gold)、公司名、五大主題、資料截止日
- 公司概況 — 左卡基本資料 bullets、右卡 4 個大數字 stat（股價/市值/P|B/營收）
- 歷史財務 — 雙圖：年度營收 BAR(navy) + 年度 EPS BAR(red)
- 最新營運動能 — 季度 EPS BAR(gold) + 月營收 LINE(navy)，底部一行最新季摘要
- 成長動能 — 3 張編號圓標卡片（01/02/03）
- 成長預測儀表板 — 類似「三情境卡 + 5 年財務預測趨勢 + Year 1-5 指標矩陣 + 底部迷你圖表」的整頁資訊圖；需呈現 Bull/Base/Bear、Revenue/EBITDA/EBIT/Net Income/EPS/FCF
- 三情境預測表 — addTable，基準列淺藍底、轉正 EPS 綠字，下方列關鍵假設與免責
- DCF + 相對估值分析 — 類似「左側 DCF 估值、右側相對估值」的整頁資訊圖；需包含 DCF 假設圖示、三情境 DCF 結果、估值區間、同業比較、P/E 或 EV/EBITDA/P/B/ROE 倍數比較、目標價區間
- 估值分析 — 情境目標價 vs 現價 BAR（現價紅色）+ 右卡解讀 bullets + 底部一句結論
- 財務指標健檢 — 2×3 卡片網格，紅黃綠圓點標示好壞
- 近期技術面：KD/MACD — KD 折線圖 + MACD/DIF/柱狀體圖，附最新 K/D/DIF/MACD/柱狀體數值與短線解讀；MACD 柱狀體必須正柱紅、負柱綠
- K 線型態圖表 — 深色 K 線圖，包含成交量、MA5/MA10/MA20、BB(20,2)、型態標記；K 線與成交量必須紅漲綠跌；可用嵌入 PNG，但來源圖要另存 HTML/PNG 供下載
- 風險矩陣 — addTable，風險值依高低紅/金/灰
- 結論（深色） — 4 列圓角卡（gold 標籤 + ice 說明）+ 資料來源與「非投資建議」免責
硬性規範（承襲 pptx 技能）：
- 圖表一律 addChart 原生圖，禁止轉圖片；禁止裝飾色條/標題底線
- 例外：K 線型態圖若原生圖表無法表現蠟燭線、成交量、布林帶與型態標記，可使用自產 HTML/SVG 渲染後的 PNG 嵌入 PPT；但必須同時交付可下載 HTML 與 PNG
writeFile 後跑 rezip.py，再轉 PDF → jpg 逐頁視覺 QA（檢查溢出、重疊、對比）- 修完一輪即停，勿無限微調
執行指令範本：
NODE_PATH=$(npm root -g) node build_ppt.js
python /mnt/skills/public/pptx/scripts/rezip.py {檔}.pptx
python /mnt/skills/public/pptx/scripts/office/soffice.py --headless --convert-to pdf {檔}.pptx
pdftoppm -jpeg -r 110 {檔}.pdf slide
第 4 步：交付
- 核心兩檔複製至
/mnt/user-data/outputs/ 或當前專案 outputs/：Excel 財務模型、PPTX 投資分析簡報
- 若有生成 K 線型態圖，必須一併提供 HTML 與 PNG 下載檔；PPTX 中也要嵌入 K 線型態圖頁
- 交付訊息（精簡、繁體中文）必含：
- 模型結構一句話 + 「改假設表藍字即全表連動」
- 誠實發現：估值高低估、獲利轉折點、現金流狀況——不美化、不唱多
- 技術圖表一句話：KD/MACD 與 K 線型態只作短線位置補充，不取代基本面估值
- 結尾註明「情境分析非投資建議」
常見陷阱
- 股本變動：EPS×股數回推淨利時要用「當年度」股本
- 虧損股別硬算 P/E；月營收缺月份時以累計數回推並標注估計
- 面板/DRAM 等景氣循環股，估值假設區間應明顯寬於一般股
- 若搜尋結果彼此矛盾（如不同網站股價差異大），以日期最新者為準並加搜尋確認
- 技術指標不要只畫圖不交付資料；至少要能在 Excel 技術表或來源表追溯日線資料與計算設定
