# InvestSkill

專業投資分析與股票評估技能工具，適用於 Claude Code。

📖 繁體中文版 (Traditional Chinese) | English

# 快速連結

📖 操作手冊 — 示範範例、安裝指南與核心概念
📝 部落格文章：InvestSkill - Claude Code 金融分析插件
📊 範例輸出：完整分析報告 (PLTR)

# 安裝


claude

# 添加到市集
/plugin marketplace add yennanliu/InvestSkill


# 安裝
/plugin install us-stock-analysis


# 檢查已安裝列表

/plugin list

# 測試
- /us-stock-analysis:fundamental-analysis AAPL # - 基本面分析
- /us-stock-analysis:technical-analysis AAPL # - 技術面分析
- /us-stock-analysis:economics-analysis # - 經濟分析

本地開發


claude

# 添加本地市集
/plugin marketplace add /Users/yennanliu/InvestSkill

# 安裝插件
/plugin install us-stock-analysis@invest-skill

# 概述

InvestSkill 是一個綜合性的 Claude Code 插件市集，提供專業級的美股市場分析技能，包括基本面分析、技術分析、經濟評估和投資組合管理。

# 功能特色

股票評估：全面的基本面與估值分析
經濟分析：美國經濟指標及市場影響分析
基本面分析：深入的財務報表分析，支援視覺化圖表
技術分析：圖表形態與技術指標分析，支援圖表生成
投資組合檢視：績效分析與優化建議
產業分析：產業輪動與市場定位分析
互動式報告：生成帶有視覺化圖表的 HTML/PDF 報告
財報電話會議分析：分析財報電話會議記錄的情緒與洞察
內部人交易追蹤：從 SEC 申報文件監控內部人買賣活動
機構持股分析：從 13F 申報追蹤聰明錢的動向

# 安裝方式

# 一般使用者

添加市集並安裝插件：

# 從 GitHub 添加市集
/plugin marketplace add yennanliu/InvestSkill

# 安裝插件
/plugin install us-stock-analysis@invest-skill

# 本地開發

# 添加本地市集
/plugin marketplace add /Users/yennanliu/InvestSkill

# 安裝插件
/plugin install us-stock-analysis@invest-skill

# 可用技能

# 核心分析技能

/stock-eval - 全面分析美股股票
/economics-analysis - 分析美國經濟指標
/fundamental-analysis - 使用財報進行深入基本面分析（支援 --visual 旗標）
/technical-analysis - 技術圖表與指標分析（支援 --chart 旗標）
/portfolio-review - 投資組合績效與優化檢視
/sector-analysis - 美股市場產業分析與輪動

# 增強數據分析（v1.1.0 新增）

/report-generator - 生成專業的 HTML/PDF 報告，包含互動式圖表
/earnings-call-analysis - 分析財報電話會議記錄的情緒、主題與管理層態度
/insider-trading - 從 SEC Form 4 申報追蹤內部人買賣活動
/institutional-ownership - 從 13F 申報監控機構持股變化

# 使用範例

# 核心分析

# 評估特定股票
/stock-eval AAPL

# 獲取經濟展望
/economics-analysis

# 深入基本面分析
/fundamental-analysis MSFT

# 帶視覺化的基本面分析
/fundamental-analysis NVDA --visual

# 技術圖表分析
/technical-analysis TSLA

# 帶圖表生成的技術分析
/technical-analysis GOOGL --chart

# 檢視投資組合
/portfolio-review [貼上您的持股]

# 分析產業
/sector-analysis

# 增強數據分析（v1.1.0）

# 生成帶視覺化的 HTML/PDF 報告
/report-generator --type comprehensive --data [貼上分析結果]

# 分析財報電話會議記錄
/earnings-call-analysis AAPL [貼上記錄或提供網址]

# 追蹤內部人交易活動
/insider-trading TSLA

# 監控機構持股變化
/institutional-ownership MSFT

# 追蹤特定機構投資者
/institutional-ownership META --smart-money

# 報告生成工作流程

# 步驟 1：執行帶視覺化的基本面分析
/fundamental-analysis AAPL --visual

# 步驟 2：從分析結果生成 HTML 報告
/report-generator --type comprehensive

# 步驟 3：在瀏覽器中開啟 HTML 檔案並匯出為 PDF
# 報告包含互動式圖表，可以列印為 PDF 格式

# 專案結構

InvestSkill/
├── .claude-plugin/
│   └── marketplace.json          # 市集配置
├── plugins/
│   └── us-stock-analysis/
│       ├── .claude-plugin/
│       │   └── plugin.json       # 插件清單
│       ├── skills/
│       │   ├── stock-eval/
│       │   │   └── SKILL.md
│       │   ├── economics-analysis/
│       │   │   └── SKILL.md
│       │   ├── fundamental-analysis/
│       │   │   └── SKILL.md      # 增強：支援視覺化
│       │   ├── technical-analysis/
│       │   │   └── SKILL.md      # 增強：支援圖表生成
│       │   ├── portfolio-review/
│       │   │   └── SKILL.md
│       │   ├── sector-analysis/
│       │   │   └── SKILL.md
│       │   ├── report-generator/
│       │   │   └── SKILL.md      # 新增：生成 HTML/PDF 報告
│       │   ├── earnings-call-analysis/
│       │   │   └── SKILL.md      # 新增：財報電話會議分析
│       │   ├── insider-trading/
│       │   │   └── SKILL.md      # 新增：內部人交易追蹤
│       │   └── institutional-ownership/
│       │       └── SKILL.md      # 新增：13F 申報分析
│       └── README.md
├── LICENSE
└── README.md

# 報告生成

InvestSkill v1.1.0 引入了專業的報告生成功能，支援互動式視覺化。

# 功能特色

HTML 報告：獨立的 HTML 檔案，內嵌 Chart.js 視覺化圖表
PDF 匯出：支援透過瀏覽器或命令列工具列印為 PDF
互動式圖表：折線圖、長條圖、K線圖等多種圖表類型
專業樣式：金融報告等級的格式與版面配置
響應式設計：支援桌面與行動裝置

# 工作流程

執行帶視覺化的分析
```
/fundamental-analysis AAPL --visual
```
生成包含圖表資料表的分析結果
生成 HTML 報告
```
/report-generator --type comprehensive
```
建立 investment-report-AAPL-20260217-143022.html
匯出為 PDF
- 瀏覽器：開啟 HTML → 列印 → 儲存為 PDF
- 命令列：wkhtmltopdf report.html report.pdf
- Node.js：使用 Playwright 或 Puppeteer

# 報告範本

執行摘要：1-2 頁，關鍵指標與圖表
完整分析：5-10 頁，詳細分析內容
投資組合檢視：多檔股票比較與配置分析

# 視覺化類型

營收/獲利成長趨勢（折線圖）
利潤率比較（折線圖）
資產負債表組成（堆疊長條圖）
現金流瀑布圖（瀑布圖）
估值倍數（分組長條圖）
價格圖表與指標（K線圖 + 疊加）
成交量分析（長條圖）
技術指標（RSI、MACD 面板）

# CI/CD 與自動化

本專案包含完整的 GitHub Actions 工作流程，用於品質保證和自動發布。

# 自動化工作流程

驗證 (validate.yml)

在每次推送和 PR 至 main/develop 分支時執行
驗證 JSON 結構 (marketplace.json, plugin.json)
檢查必要檔案和欄位
驗證 SKILL.md frontmatter
確保檔案間的版本一致性

PR 檢查 (pr-check.yml)

在 Pull Request 上進行快速驗證
JSON 語法檢查
必要欄位驗證
SKILL.md 檔案檢查

自動發布 (release.yml)

在版本標籤 (v*) 觸發
建立發布套件 (.tar.gz)
生成 SHA256 校驗碼
建立包含附件的 GitHub 發布
從 CHANGELOG.md 提取發布說明

自動標籤 (label-pr.yml)

根據變更的檔案自動為 PR 加上標籤
添加大小標籤 (small/medium/large)
協助 PR 組織和審查

首次貢獻者問候 (greetings.yml)

歡迎新貢獻者
為首次提交 issues/PR 提供有用資訊

# 建立發布版本

建立新版本的步驟：

更新版本號碼：

# 更新 plugins/us-stock-analysis/.claude-plugin/plugin.json
# 更新 .claude-plugin/marketplace.json

更新 CHANGELOG.md：

## [1.1.0] - 2026-02-16
### Added
- 新功能描述

提交變更：

git add .
git commit -m "chore: bump version to 1.1.0"
git push origin main

建立並推送標籤：
```
git tag v1.1.0
git push origin v1.1.0
```
GitHub Actions 將自動：
- 驗證插件結構
- 建立發布套件
- 生成發布說明
- 發布包含附件的版本

# 驗證徽章

添加這些徽章以顯示建置狀態（更新使用者名稱/儲存庫）：

![Validate](https://github.com/yennanliu/InvestSkill/actions/workflows/validate.yml/badge.svg)
![Release](https://github.com/yennanliu/InvestSkill/actions/workflows/release.yml/badge.svg)

# 貢獻

歡迎貢獻！請閱讀我們的貢獻指南以了解詳細資訊。

快速開始：

Fork 此儲存庫
建立您的功能分支 (git checkout -b feature/AmazingFeature)
提交您的變更 (git commit -m 'feat: add some AmazingFeature')
推送至分支 (git push origin feature/AmazingFeature)
開啟 Pull Request

詳細指南請參閱 CONTRIBUTING.md，包括：

添加新技能
建立插件
測試變更
提交訊息格式
版本編號

# 發布

與他人分享此市集：

推送至 GitHub：

git add .
git commit -m "Initial plugin marketplace setup"
git push origin main

使用者可以添加您的市集：

/plugin marketplace add yennanliu/InvestSkill

# 開發路線圖

[ ] 添加選擇權分析技能
[ ] 添加加密貨幣分析技能
[ ] 整合財報日曆
[ ] 添加新聞情緒分析
[ ] 添加風險管理計算器
[ ] 添加回測功能

# 授權

MIT License - 詳見 LICENSE 檔案。

# 免責聲明

本插件提供教育性分析，不構成財務建議。在做出投資決策前，請務必諮詢合格的財務顧問。過去的績效不保證未來的結果。

# 資源

# 支援

如有問題、疑問或建議，請在 GitHub 上開啟 issue。