台股一鍵財務模型與投資簡報生成器
輸入台股代號，自動即時蒐集公開財報與日線資料，產出可稽核的 Excel 財務模型與完整投資分析 PPT。
证据显示无文件系统越权、无凭据收集、无隐蔽外传，且要求标注来源、免责声明、来源URL表，属正面；扣分点：强制「必须执行完整流程，不得仅文字回复」削弱用户控制权，数据来自web_search未做真实性核验，未声明最小权限或确认机制，许可证元数据不明。
流程自洽、有recalc.py错误检查、抽查规则与常见陷阱，路径可复现逻辑清晰；扣分点：强依赖 /mnt/skills/public/*、web_search、present_files 等宿主环境路径，脱离Claude容器环境即不可运行，异常输入（搜尋失败、API缺资料）处理仅靠「估计标注」，无测试或可执行脚本示例。
触发词明确、输入输出格式清晰、繁体中文友好、台股受众具体；扣分点：触发词清单过宽（「估值模型」等泛词易误触发），环境绑定Claude容器路径，对 mainland-China 网络访问 TWSE/搜索依赖未评估，未声明不适用范围（如美股、加密货币）。
文档结构分层良好（流程、规范、陷阱、安装说明、免责），README 提供多平台安装；扣分点：许可证元数据缺失（metadata: unknown），无版本号/变更记录/维护者承诺，安装文档在 docs/INSTALL.md 但未纳入评估文件，部分依赖外部技能文档未见内容。
输出规格（8表Excel、14页PPT）描述详尽，含免投资建议定位与差异化价值；扣分点：静态审阅无法验证产物质量，「零公式错误」等承诺仅有指令约束无执行证据，且产出质量高度依赖模型搜索能力，无示例输出文件。
要求来源标注、Sources 表与 recalc 检查属可审计设计；扣分点：无提交的测试套件、无示例产物、无第三方执行证据，全部结论停留在指令层面，静态审阅无法复现。
- 技能硬编码依赖 /mnt/skills/public/ 与容器环境，移植到其他环境大概率无法按描述运行。
- 无许可证元数据与版本/维护信息，使用前请确认仓库许可证与更新状态。
- 财务数据来自即时网络搜索，准确性不由技能保证，投资决策前务必自行核对原始来源。
- 触发词范围过宽，可能在用户未预期时自动触发完整耗时流程。
- 核心为中国大陆以外服务（TWSE、搜索引擎），大陆网络可达性未验证。
这个 Skill 能做什么，适合哪些场景？
這是一個給 Claude / Codex 使用的 Agent Skill，把台股代號轉成完整的分析產出。它會即時搜尋最新公開財務數據與至少 60 個交易日的日線資料，然後生成一套公式連動的 Excel 財務模型（三情境預測、P/B 與 P/S 估值、敏感度表、KD/MACD 技術指標、風險矩陣）與一份至少 14 頁的投資分析 PPTX，必要時附上可下載的 K 線型態 HTML/PNG 圖表。它的定位是分析與教學輔助，不是自動投資建議，交付時必須包含誠實發現與免責聲明。適合需要快速把台股公開資料整理成可調整、可展示素材的使用者。
觸發後執行五步流程：①用 web_search 進行 3-5 次搜尋，蒐集近三年營收/EPS、近五季 EPS、月營收、每股淨值、最新股價與風險題材，並要求標注每個數字的來源與日期；②從 TWSE/TPEx 官方日成交資訊抓取日線，計算 MA5/10/20、布林通道(20,2)、KD(9,3,3)、MACD 與規則式 K 線型態標記（突破、缺口、十字線、黃金/死亡交叉）；③用 openpyxl 生成至少 8 張工作表的 Excel 模型，全部以 Excel 公式計算（禁止 Python 硬編碼），跑 recalc.py 驗證 total_errors: 0；④用 pptxgenjs 生成至少 14 頁、Midnight Executive 配色、微軟正黑體的簡報，圖表一律原生 addChart，再經 rezip.py 與逐頁視覺 QA；⑤把財務模型 .xlsx、投資簡報 .pptx（及 K 線圖 .html/.png）交付到 outputs 目錄，附上誠實發現與「非投資建議」聲明。
- 個人投資人想快速檢視一檔台股（如 2330、6116）的估值與三情境目標價，而不想手動整理財報
- 財務教學或讀書會需要一份假設可調、公式可追溯的 Excel 模型作為教材
- 分析師需要附 KD/MACD 與 K 線型態的簡報頁，補充短線技術面位置
- 面對虧損股或面板/DRAM 景氣循環股，需要以 P/B 為主軸的估值框架與較寬的假設區間
- 需要把月營收、季 EPS、風險矩陣與資料來源一次整理成可交付的書面素材
这个 Skill 有哪些优点和局限？
- 產出結構完整：Excel 至少 8 張工作表、PPT 至少 14 頁，涵蓋財務、估值、技術指標與風險
- 強調可稽核性：所有硬編碼數字標注來源與日期，計算全用 Excel 公式，並強制 recalc.py 驗證零錯誤
- 尊重台股圖表慣例（紅漲綠跌），有明確的配色硬性規範
- 資料誠信設計：推算值須標注方式、規則式型態偵測須標註、交付必含誠實發現與免責
- 依賴 web_search 與 TWSE/TPEx 資料可得性；搜尋結果矛盾時以最新日期為準，數據品質取決於即時搜尋
- 參照 /mnt/skills/public/xlsx、pptx 的內建腳本路徑，在自架或其他環境需自備對應工具
- 缺少授權資訊（License: unknown），商業採用前應先確認
- 無測試套件或範例產出可驗證品質；K 線型態為規則式偵測，明確不等同投資訊號
- 對無殼環境（純 API 呼叫）不可直接使用，需自行提供 Python/Node 執行環境
如何安装这个 Skill？
Codex：把 skills/ai-stock-report-generator/SKILL.md 複製到 ~/.codex/skills/ai-stock-report-generator/SKILL.md（Windows 可用 PowerShell 的 New-Item 與 Copy-Item 指令，README 有範例），重啟 Codex。Claude Code：放到專案的 .claude/skills/ai-stock-report-generator/SKILL.md 或 ~/.claude/skills/ai-stock-report-generator/SKILL.md。完整安裝細節見 repo 的 docs/INSTALL.md。注意 SKILL.md 參考 /mnt/skills/public/xlsx 與 pptx 的腳本與規範（recalc.py、rezip.py 等），這些是 Claude 平台內建路徑，其他環境需自行準備對應腳本。
如何使用这个 Skill？
輸入台股代號（4-6 位數字）加上觸發詞即可，例如：2303 //ai-stock-report-generator；或自然語言如「幫我做 2303 的估值和簡報」「建立 6116 財務模型」「2330 財務模型整理成 PPT」。技能會執行完整流程並產出 {代號}_{名稱}_財務模型.xlsx 與 {代號}_{名稱}_投資分析簡報.pptx（含 K 線圖 HTML/PNG，若有生成）。改 Excel「假設」表的藍字輸入即可全表連動。