ai-stock-report-generator

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}=代號、{名}=公司名）：

1. {N} {名} 全年財報 EPS 營收 — 近三年年度營收、EPS
2. {名} {N} 股價 今日 每股淨值 — 最新收盤價、股淨比/每股淨值
3. {名} {N} 股價 大漲/展望 產業 — 題材、成長動能、法人觀點
4. （選配）{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，深色封面與結論夾淺色內容）：

1. 封面 — 代號大字(gold)、公司名、五大主題、資料截止日
2. 公司概況 — 左卡基本資料 bullets、右卡 4 個大數字 stat（股價/市值/P|B/營收）
3. 歷史財務 — 雙圖：年度營收 BAR(navy) + 年度 EPS BAR(red)
4. 最新營運動能 — 季度 EPS BAR(gold) + 月營收 LINE(navy)，底部一行最新季摘要
5. 成長動能 — 3 張編號圓標卡片（01/02/03）
6. 成長預測儀表板 — 類似「三情境卡 + 5 年財務預測趨勢 + Year 1-5 指標矩陣 + 底部迷你圖表」的整頁資訊圖；需呈現 Bull/Base/Bear、Revenue/EBITDA/EBIT/Net Income/EPS/FCF
7. 三情境預測表 — addTable，基準列淺藍底、轉正 EPS 綠字，下方列關鍵假設與免責
8. DCF + 相對估值分析 — 類似「左側 DCF 估值、右側相對估值」的整頁資訊圖；需包含 DCF 假設圖示、三情境 DCF 結果、估值區間、同業比較、P/E 或 EV/EBITDA/P/B/ROE 倍數比較、目標價區間
9. 估值分析 — 情境目標價 vs 現價 BAR（現價紅色）+ 右卡解讀 bullets + 底部一句結論
10. 財務指標健檢 — 2×3 卡片網格，紅黃綠圓點標示好壞
11. 近期技術面：KD/MACD — KD 折線圖 + MACD/DIF/柱狀體圖，附最新 K/D/DIF/MACD/柱狀體數值與短線解讀；MACD 柱狀體必須正柱紅、負柱綠
12. K 線型態圖表 — 深色 K 線圖，包含成交量、MA5/MA10/MA20、BB(20,2)、型態標記；K 線與成交量必須紅漲綠跌；可用嵌入 PNG，但來源圖要另存 HTML/PNG 供下載
13. 風險矩陣 — addTable，風險值依高低紅/金/灰
14. 結論（深色） — 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 步：交付

1. 核心兩檔複製至 /mnt/user-data/outputs/ 或當前專案 outputs/：Excel 財務模型、PPTX 投資分析簡報
2. 若有生成 K 線型態圖，必須一併提供 HTML 與 PNG 下載檔；PPTX 中也要嵌入 K 線型態圖頁
3. 交付訊息（精簡、繁體中文）必含：
   • 模型結構一句話 + 「改假設表藍字即全表連動」
   • 誠實發現：估值高低估、獲利轉折點、現金流狀況——不美化、不唱多
   • 技術圖表一句話：KD/MACD 與 K 線型態只作短線位置補充，不取代基本面估值
   • 結尾註明「情境分析非投資建議」

常見陷阱

• 股本變動：EPS×股數回推淨利時要用「當年度」股本
• 虧損股別硬算 P/E；月營收缺月份時以累計數回推並標注估計
• 面板/DRAM 等景氣循環股，估值假設區間應明顯寬於一般股
• 若搜尋結果彼此矛盾（如不同網站股價差異大），以日期最新者為準並加搜尋確認
• 技術指標不要只畫圖不交付資料；至少要能在 Excel 技術表或來源表追溯日線資料與計算設定