balance-sheet-analyzer

資產負債表分析教學助手 Balance Sheet Analyzer


專為經濟/財務/會計課教師設計的 Claude Code Plugin，協助快速解讀上市公司資產負債表、計算財務比率、產出課堂視覺化圖表。

功能

• 比率計算 — 流動比率、速動比率、現金比率、負債比率、D/E、權益乘數、ROE、ROA
• 視覺化圖表 — Chart.js 產出資產結構堆疊圖、負債權益環形圖、財務健康雷達圖
• 真實財報搜尋 — 支援中英雙語搜尋台灣及國際上市公司財報資料
• 圖片 OCR — 上傳財報截圖或照片，自動辨識數字
• CSV/Excel 解析 — 直接讀取結構化財報資料
• 課堂練習題 — 自動產出教師版（含答案）與學生版
• 中英對照 — 預設繁體中文輸出，科目名稱附英文

安裝

方法一：Plugin Marketplace（推薦）

在 Claude Code 中執行：

/plugin marketplace add cwstedctw/balance-sheet-analyzer
/plugin install balance-sheet-analyzer@balance-sheet-analyzer-marketplace

方法二：手動安裝

git clone https://github.com/cwstedctw/balance-sheet-analyzer.git
# 複製 skill 到專案目錄
cp -r balance-sheet-analyzer/skills/balance-sheet-analyzer /path/to/project/.claude/skills/
# 或複製到全域目錄
cp -r balance-sheet-analyzer/skills/balance-sheet-analyzer ~/.claude/skills/

依賴

• Python >= 3.8
• pandas（CSV/Excel 解析用，選用）

使用範例

安裝後在 Claude Code 中直接說：

幫我查台積電 2024 資產負債表

幫我算一下這些數字的財務比率：總資產 5000、總負債 2000、股東權益 3000...

做一個台積電的財務健康雷達圖

幫我出一份流動比率的課堂練習題

檔案結構

balance-sheet-analyzer/
├── .claude-plugin/
│   ├── marketplace.json        # Plugin Marketplace 定義
│   └── plugin.json             # Plugin manifest
├── skills/
│   └── balance-sheet-analyzer/
│       ├── SKILL.md            # Skill 定義（Claude Code 讀取）
│       ├── assets/             # 範例輸出（待補）
│       ├── references/
│       │   ├── glossary.md     # 中英術語對照 + 產業基準
│       │   ├── demo-data-tsmc.md  # 台積電示範資料
│       │   ├── search-sources.md  # 財報搜尋策略
│       │   └── tw-companies.md    # 台灣教學公司列表
│       └── scripts/
│           ├── calc_ratios.py          # 財務比率計算器
│           ├── generate_chart.py       # Chart.js 圖表產生器
│           ├── test_calc_ratios.py     # 回歸測試
│           └── test_generate_chart.py  # 回歸測試
├── README.md
├── LICENSE
└── CHANGELOG.md

獨立使用 Python 腳本

不透過 Claude Code 也可以直接使用：

# 計算比率（使用內建台積電示範資料）
python skills/balance-sheet-analyzer/scripts/calc_ratios.py

# 計算比率（自訂 JSON）
python skills/balance-sheet-analyzer/scripts/calc_ratios.py --json '{"company_name":"範例公司","total_assets":1000,...}'

# 產出圖表
python skills/balance-sheet-analyzer/scripts/generate_chart.py --output charts.html

Codex 使用者

此 skill 目前為 Claude Code plugin 格式。OpenAI Codex 使用不同的 skills 系統，無法直接安裝。但你仍可以：

• 直接使用 scripts/calc_ratios.py 和 scripts/generate_chart.py
• 將 SKILL.md 的內容作為 Codex 自訂指令的參考

貢獻

歡迎提交 Pull Request！

License

MIT