讓任何 AI 成為你的美股分析師。

🎯 什麼是 InvestSkill？

InvestSkill 是企業級投資分析工具包，為各 AI 平台帶來機構級分析框架。透過 34 個完整框架進行專業股票分析——無需金融執照，無需 API 費用。

不用註冊，也不用付費。 沒有 API 金鑰、沒有資料商訂閱、不必設定帳單——你只要用手上已有的 AI 助理（免費方案或本機模型都可以），InvestSkill 本身就只是 markdown 提示詞。詳見 無需 API 金鑰，完全免費。

適合用於：投資研究 · 盡職調查 · 投資組合管理 · 金融教育 · 股票評估

🚀 快速開始（30 秒）

一行指令安裝（推薦）

在官網選擇你的 AI 工具，或直接執行：

# Claude Code
curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a claude

# 換成你的工具：cursor · copilot · gemini · codex · opencode · any
curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a cursor

安裝腳本會把所有框架複製到 .investskill/prompts/，並接上該工具自己的入口設定：

加上 -g 可安裝到使用者層級（而非單一專案）、-d DIR 指定目錄、-h 查看所有選項。既有的指令檔只會附加、不會覆蓋，重複執行不會產生重複內容。不想直接 pipe 到 bash？先看過腳本：install.sh。

Claude Code（外掛市集）

claude
/plugin marketplace add yennanliu/InvestSkill
/plugin install us-stock-analysis@invest-skill
/us-stock-analysis:stock-eval AAPL

或複製整個儲存庫

git clone https://github.com/yennanliu/InvestSkill.git
cd InvestSkill
cursor .   # Cursor／Copilot：@prompts/stock-eval.md 評估蘋果公司
gemini     # Gemini CLI：> @prompts/stock-eval.md 評估蘋果公司

💸 無需 API 金鑰，完全免費

使用 InvestSkill 完全免費——沒有任何東西要購買、註冊或設定。

你唯一需要的，是手上已經在用的 AI 助理。 可以是付費方案（Claude Code、Cursor、Copilot）、免費方案（ChatGPT、Gemini、Claude.ai），也可以是透過 Ollama 完全離線的本機模型——用後者跑完所有框架，總成本就是 0。

因為沒有 API，也就沒有任何遙測：InvestSkill 不會看到你的股票代號、你的持股，或你的分析內容。數字實際從何而來，請見資料與準確性。

也能用繁體中文。 在任何框架後面加上 --lang zh-TW，整份分析——標題、內文與表格——都會以繁體中文輸出；Data & Sources 的欄位名稱、訊號方框與 JSON footer 則維持英文，讓工具仍能讀取。網站另有中文技能參考與非美國投資人指南。

自備資料。 申報文件類技能（10k-digest、financial-report-analyst、fact-check）內建一份無金鑰的 SEC EDGAR 取檔步驟，具工具能力的助理可自行照做。若你的助理無法上網，倉庫另附兩支可選、零相依的腳本替你抓取第一手來源供貼上——node scripts/fetch-edgar.js AAPL --form 10-K 把文件存成純文字，node scripts/fetch-fundamentals.js AAPL 從 SEC 的 XBRL 數據產生已對帳的財報資料包。兩者都不屬於外掛本體。詳見資料與準確性頁。

🏆 核心功能

📋 34 個框架總覽

各版本新增了哪些技能與功能，請見 CHANGELOG（英文）。

💡 實際應用場景

/us-stock-analysis:stock-eval TARGET
/us-stock-analysis:financial-report-analyst TARGET 10-K
/us-stock-analysis:competitor-analysis TARGET --peers COMPETITORS
/us-stock-analysis:stock-valuation TARGET --methods all
→ 數分鐘內完成機構級估值報告

/us-stock-analysis:portfolio-review
[貼上您的持股]
→ 配置分析與優化建議

/us-stock-analysis:stock-eval TICKER --visual
/us-stock-analysis:earnings-call-analysis TICKER
[貼上電話會議記錄]
→ 管理層語調、業績指引、風險與機會

/us-stock-analysis:technical-analysis TICKER --chart
/us-stock-analysis:options-analysis TICKER --earnings
→ 技術面設置 + 波動率預期 → 策略選擇

🎓 學習這些框架

投資新手，或不確定該用哪個技能？從這裡開始：

🛠️ 安裝方式

curl 一行安裝（所有工具通用）

curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -a AGENT
# AGENT = claude | cursor | copilot | gemini | codex | opencode | any
curl -fsSL https://raw.githubusercontent.com/yennanliu/InvestSkill/main/install.sh | bash -s -- -l   # 查看各工具安裝位置

詳細對照表見上方快速開始。

Claude Code（一般使用者推薦）

claude
/plugin marketplace add yennanliu/InvestSkill
/plugin install us-stock-analysis@invest-skill
/plugin list  # 確認安裝

驗證安裝：

node scripts/setup-verify.js

Cursor、Gemini CLI、GitHub Copilot、Codex、OpenCode

用上方的 install.sh 指令，把 -a 換成 cursor／gemini／copilot／codex／opencode 即可——安裝後規則檔（.cursor/rules/investskill.mdc、GEMINI.md、.github/copilot-instructions.md、AGENTS.md）會自動載入，所有提示詞位於 .investskill/prompts/。

通用存取（任何 AI）

1. install.sh -a any（或直接複製儲存庫），取得 .investskill/prompts/
2. 複製提示詞：cat .investskill/prompts/stock-valuation.md | pbcopy
3. 貼入 ChatGPT、Claude.ai 或任何大型語言模型後提問

🎓 範例工作流程

工作流程 1：快速股票篩選

# 5 分鐘評估
/stock-eval NVDA
/stock-eval AMD
/stock-eval QCOM
→ Piotroski 評分、ROIC、風險矩陣，快速決策

工作流程 2：完整盡職調查

# 完整機構級分析
/stock-eval AAPL --visual
/technical-analysis AAPL --chart
/stock-valuation AAPL --methods all
/competitor-analysis AAPL --moat
/financial-report-analyst AAPL 10-K
→ 相當於完整 50 頁分析報告

工作流程 3：財報季研究

# 30 分鐘財報研究流程
/stock-eval TICKER --visual  # 財報前基準線
/earnings-call-analysis TICKER [貼上電話會議記錄]  # 財報後分析
/technical-analysis TICKER --chart  # 技術面設置
/options-analysis TICKER --earnings  # 波動率預期
→ 完整財報投資論點

工作流程 4：投資組合優化

/portfolio-review [貼上您的持股]
→ 配置分析 + 再平衡建議

✨ InvestSkill 的差異化優勢

📊 專案狀態

版本： 最新版——見 CHANGELOG 技能框架： 34 個（另有 3 個別名、1 個輸出工具） 通用提示詞： 38 個 支援平台： 7 個 測試： 全數通過 ✅（結構、提示詞同步、技能契約、數量一致性、安裝腳本）

🤝 貢獻

添加新技能

詳見 ADDING-NEW-SKILLS.md 完整指南。簡要流程：

1. node scripts/new-skill.js <name> --category <core|reports|monitoring|advanced|meta> --title "…" --desc "…"——建立含完整輸出合約的 SKILL.md，並把技能接到網站、README、跨 AI 設定檔與 CHANGELOG
2. 撰寫 plugins/us-stock-analysis/skills/<name>/SKILL.md，再執行 node scripts/sync-prompts.js <name> 產生 prompts/<name>.md
3. 執行 npm test，確認全部通過

回報問題

發現錯誤？請開啟 Issue 並附上：

• 平台與版本
• 重現步驟
• 預期與實際行為

⚖️ 法律聲明

僅供教育用途。 InvestSkill 提供分析框架，用於學習與研究目的。

本工具包不構成財務建議。請務必：

• 諮詢合格的財務顧問
• 自行研究（DYOR）
• 獨立驗證分析結果
• 考量個人風險承受度

過去績效不代表未來結果