yangchunyi0814 GitHub avatar

ai-stock-report-generator

yangchunyi0814

An agent skill for Claude/Codex that converts Taiwan stock tickers into comprehensive financial models, investment analysis presentations, and technical charts using public data.

Stars

23

7-day growth

No data

Forks

11

Open issues

0

License

No data

Last updated

2026-07-05

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It bridges AI assistants with structured financial analysis, producing multiple audit-ready file formats (Excel, PPT, HTML, PNG) that are customizable and educational, while strictly adhering to Taiwan market color conventions and transparency principles.

Who it is for

  • Taiwan stock investors seeking detailed, auditable reports
  • Financial analysts who need automated model generation
  • Educators teaching financial modeling and valuation
  • AI developers integrating agent skills for finance

Use cases

  • Generate a complete financial model and investment deck for a Taiwan-listed company
  • Create scenario-based DCF and relative valuation analyses with sensitivity tables
  • Produce technical analysis charts (K-line, KD, MACD) with proper Taiwan color conventions
  • Develop a teaching demonstration of financial statement analysis and forecasting

Strengths

  • Outputs multiple formats (Excel, PPTX, HTML, PNG) with comprehensive sections (historical data, forecasts, valuation, risk matrix)
  • Enforces auditable data sources and adjustable assumptions for transparency
  • Respects Taiwan market conventions (red for gains, green for losses) in charts
  • Designed for educational and analytical purposes, not as automatic investment advice

Considerations

  • Only supports Taiwan stocks (台股)
  • Requires specific installation as a skill in Claude/Codex, not standalone
  • Depends on external data sources and agent capabilities, may have API limitations
  • Disclaimer states no investment guarantee; users must verify data and bear risks

README quick start

AI Stock Report Generator

ai-stock-report-generator 是一個給 Claude / Codex 使用的 Agent Skill,用來把台股代號轉成完整的財務模型、投資分析簡報與技術圖表。它的核心目標不是直接給買賣建議,而是把公開資料整理成可稽核、可調整、可教學展示的分析素材。

目前技能名稱:ai-stock-report-generator

這個 Skill 會做什麼

輸入一個台股代號,例如:

2303 //ai-stock-report-generator

或用自然語言:

幫我做 2303 的估值和簡報
建立 6116 財務模型
2330 財務模型整理成 PPT

Skill 會要求代理完成以下工作:

  1. 即時搜尋公開財務資料與近期日線資料。
  2. 建立 Excel 財務模型。
  3. 建立投資分析 PowerPoint 簡報。
  4. 產出 KD / MACD 技術指標。
  5. 產出 K 線型態圖表。
  6. 製作成長預測儀表板。
  7. 製作 DCF + 相對估值分析頁。
  8. 保留資料來源與檢查結果。

主要輸出

典型輸出包含:

{代號}_{名稱}_財務模型.xlsx
{代號}_{名稱}_投資分析簡報.pptx
{代號}_{名稱}_K線型態圖表.html
{代號}_{名稱}_K線型態圖表.png

Excel 內容至少包含:

  • Cover / 總覽
  • Assumptions / 假設
  • Historical / 歷史財務
  • Forecast / 三情境預測
  • Valuation / 估值
  • Sensitivity / 敏感度
  • Technical / 技術指標
  • RiskMatrix / 風險矩陣
  • Sources / 資料來源
  • Checks / 檢查表

PPTX 內容至少包含:

  • 公司概況
  • 歷史財務
  • 最新營運動能
  • 成長動能
  • 成長預測儀表板
  • 三情境預測表
  • DCF + 相對估值分析
  • 估值分析
  • 財務指標健檢
  • KD / MACD 技術面
  • K 線型態圖表
  • 風險矩陣
  • 結論

重要設計原則

這個 Skill 的定位是「分析與教學輔助」,不是自動投資建議。

要求代理遵守:

  • 必須標示資料來源。
  • 不得把估值結果包裝成保證。
  • 不得只用文字回覆,必須產出檔案。
  • 假設要可調整。
  • Excel 公式錯誤要檢查。
  • 技術指標只作短線位置補充,不取代基本面估值。
  • K 線型態若為規則式偵測,必須明確標註。
  • 台股圖表必須使用台灣慣例:紅色代表上漲 / 正值 / 偏多,綠色代表下跌 / 負值 / 偏空;K 線、成交量與 MACD 柱狀體不得做成綠漲紅跌。

安裝方式

完整安裝方式請看:

docs/INSTALL.md

快速說明:

Codex

skills/ai-stock-report-generator/SKILL.md 放到:

~/.codex/skills/ai-stock-report-generator/SKILL.md

Windows 範例:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\skills\ai-stock-report-generator"
Copy-Item .\skills\ai-stock-report-generator\SKILL.md "$env:USERPROFILE\.codex\skills\ai-stock-report-generator\SKILL.md" -Force

重啟 Codex 後使用:

2303 //ai-stock-report-generator

Claude Code

skills/ai-stock-report-generator/SKILL.md 放到專案或使用者的 Claude skills 目錄,例如:

.claude/skills/ai-stock-report-generator/SKILL.md

或:

~/.claude/skills/ai-stock-report-generator/SKILL.md

使用時輸入:

使用 ai-stock-report-generator,幫我產出 2303 的財務模型與投資簡報

官方格式參考

  • OpenAI Codex Skills:
  • Claude Agent Skills:
  • Claude Code Skills:

免責聲明

本專案只提供資料整理、情境分析、模型生成與教學展示用途,不構成投資建議。使用者應自行確認資料正確性,並自行承擔投資決策風險。

Description

台股分析報告

Related repositories

Similar projects matched by category, topics, and programming language.

MoonshotAI
Featured
MoonshotAI GitHub avatar

Kimi-K3

Kimi K3 is an open-weight, 2.8T-parameter native multimodal agentic model with a 1M-token context window, designed for frontier coding, knowledge work, and reasoning tasks.

AI & Machine LearningAI Agents
3,348
xuchonglang
Featured
xuchonglang GitHub avatar

investing-for-beginners

A structured investing guide for Chinese beginners covering US stocks, options, and cryptocurrency, with focus on foundational concepts and risk awareness.

Blockchain & Web3
2,739
Krishnagangwal
Featured
Krishnagangwal GitHub avatar

CS-Fundamentals

A curated collection of Computer Science fundamentals (PDFs, notes, cheatsheets, interview question banks) for placement preparation, covering seven core subjects plus general resources.

Data & DatabasesDatabases & Storage
2,326