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

🎯 什麼是 InvestSkill？

InvestSkill 是企業級投資分析工具包，為各 AI 平台帶來機構級分析框架。透過 30 個完整框架進行專業股票分析——無需金融執照，無需 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
/us-stock-analysis:stock-eval AAPL

Cursor 或 GitHub Copilot

git clone https://github.com/yennanliu/InvestSkill.git
cd InvestSkill
cursor .  # 或使用 GitHub Copilot
@prompts/stock-eval.md 評估蘋果公司

Gemini CLI

cd /path/to/InvestSkill
gemini
> @prompts/stock-eval.md 評估蘋果公司

💸 無需 API 金鑰，完全免費

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

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

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

自備資料。 申報文件類技能（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 數據產生已對帳的財報資料包。兩者都不屬於外掛本體。詳見資料與準確性頁。

🏆 核心功能

📋 30 個框架總覽

v1.12.0 新功能：

• 無金鑰的 SEC EDGAR 取檔路徑 — 10k-digest、financial-report-analyst、fact-check 內建具工具能力的助理可自行照做的取檔步驟（代號 → CIK → 申報索引 → 文件本體 → XBRL 數據）；助理無法上網時，兩支可選、零相依的腳本 scripts/fetch-edgar.js（申報文件存成純文字）與 scripts/fetch-fundamentals.js（由 XBRL 產生已對帳的財報資料包）替你抓第一手來源供貼上。不屬於外掛本體、離線測試涵蓋
• install.sh — 一行 curl 指令把全部框架安裝到任何 AI 代理（Claude Code、Cursor、Copilot、Gemini CLI、Codex、OpenCode 或任何 LLM）；文件網站全面改版；學習專區新增第二部（第 9–13 課與「答案是不」案例）
• fact-check（事實查核）— 對任何報告做逐條陳述層級的查核：抽出每個數字與事實陳述、逐一對照第一手來源（SEC 申報、IR 新聞稿、FRED、發行商資料或你貼上的文件）、重算衍生數字，標示 ✅ 已查核／⚠️ 不符／❓ 無法查核／🕒 過時，並重新產出附行內引用與參考文獻章節的修正版報告；查核分數 0–10 供 result-validator 的資料品質維度使用。絕不捏造來源
• etf-analysis（ETF 分析）— ETF／指數基金盡職調查：費用率 vs. 同類、追蹤差異、流動性、持股集中度與傾斜、與你其他持股的重疊 %、配息與資本利得分配紀錄、結構警示（槓桿／反向／合成／ETN），以及「買 ETF vs. 直接買前五大成分股」比較；產出 ETF 適配分數 0–10
• earnings-preview（財報前瞻）— 財報前的技能：共識 vs. 耳語、過去 8 季超預期比率與財報後漲跌、選擇權隱含波動 vs. 實際波動、目前股價已反映什麼、要看的 KPI，以及三情境矩陣（超預期且上修／超預期但下修／未達預期）與每個情境的部位規則
• tax-lens（稅務視角）— 美國稅務機制：短期 vs. 長期、洗售窗口檢查、合格股息持有期間測試、批次選擇、稅損收割配對、帳戶配置、年度稅務拖累估計；--non-us 模組涵蓋 W-8BEN、30% 預扣稅（或協定稅率；台灣無協定）、非居民資本利得的一般處理、6 萬美元以上美國境內資產的遺產稅曝險、愛爾蘭 UCITS 替代方案。僅供教育，非稅務建議
• risk-stress-test（風險壓力測試）— 貝他加權曝險、歷史情境重演（2008、2020 年 3 月、2022 升息、2025 關稅）、95／99% VaR 與 CVaR、最大回撤估計、相關性飆升情境、利率／美元／油價敏感度、流動性（以 20% 日均量出清所需天數）；風險預算分數 0–10
• learning-coach（學習教練）— 把任何 InvestSkill 輸出當成教材：每個指標的白話意義、為何重要、好壞區間、對應課程，接著 3–5 個蘇格拉底式問題與「什麼會改變你的看法？」；--level、--lang zh-TW、--quiz <課程> 模式
• thesis-tracker（論點追蹤）— 把一份分析變成「與未來自己的契約」：一段可被證偽的論點、3–5 個附門檻的 KPI、失效觸發條件（從各技能的「論點失效條件」與 bear-case 的論點反證匯入）、催化劑日期、事前驗屍與決策日誌，存成 output/thesis/<TICKER>.md；--update 以新資料重新檢查並回傳 INTACT / WEAKENED / BROKEN 與具體改變的那一行
• fundamental-analysis、dcf-valuation、research-bundle 重新歸類為別名（轉址存根）：仍可安裝與使用，但不再計入框架數（當時的組成：24 框架 + 3 別名 + 1 輸出工具）
• 每個分析技能都必須輸出 Data & Sources 表頭、資料驗證關卡與論點失效條件，由 scripts/check-skill-contract.js 在 npm test 中強制執行

v1.11.0 新功能：

• position-ladder（分批建倉與降成本）— 單一持股的執行計畫：先控倉（設定持股下限／上限與集中度上限），再分批布局（依 ATR／百分比／支撐位設定加碼階梯），並在股價高於平均成本時賣出成本最高的批次、低於平均成本時再買回，於區間內循環降低整體成本。內含稅務批次選擇（FIFO vs. 指定批次）、洗售規則（wash sale）警示、總報酬 vs. 買進持有的誠實對照，以及「論點破損就停止加碼」的出場閘門

v1.10.0 新功能：

• industry-map（產業地圖）— 以有向圖繪製產業供應／價值鏈（上游→下游）：定位公司所處環節、找出瓶頸卡位（收費站）與利潤池、預判價值移轉方向，並產出各層級的二階投資點子

v1.9.0 新功能：

• bear-case（空頭觀點）— 刻意單邊的放空者紅隊分析：建構最強空頭論點、會計紅旗、下檔目標價與「論點反證」，為任何多頭論點提供反面證據

v1.8.1 新功能：

• 10k-digest（10-K 摘要）— 深度解析年報並輸出結構化 Markdown 文件，包含摘要、各節重點、關鍵指標表與來源引用，支援英文 / 繁體中文輸出

v1.8.0 新功能：

• stock-screener（股票篩選器）— 跨估值、品質、動能、情緒、成長五個維度對多支股票進行排名篩選，輸出排行榜、精選名單與迴避名單
• catalyst-calendar（催化劑日曆）— 未來 90 天事件日曆：財報、總經事件、公司特定催化劑、影響力評分、事件驅動策略建議

v1.8.0 合併整合（減少重複）：

• dcf-valuation 合併至 stock-valuation — stock-valuation 現為包含完整 DCF 的超集版本；dcf-valuation 轉為精簡導引
• fundamental-analysis 合併至 stock-eval — stock-eval 吸收深度財務報表分析；fundamental-analysis 轉為精簡導引
• research-bundle 統一至 full-report — full-report 新增 --depth quick/standard/comprehensive 旗標

💡 實際應用場景

/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
/plugin list  # 確認安裝

驗證安裝：

node scripts/setup-verify.js

Cursor IDE（自動載入）

git clone https://github.com/yennanliu/InvestSkill.git
cd InvestSkill
cursor .
# 在 AI Chat（Cmd+K）中規則會自動載入

Gemini CLI（自動載入）

cd /path/to/InvestSkill
gemini
# GEMINI.md 自動載入
# 所有提示詞可透過 @prompts/ 使用

GitHub Copilot（自動載入）

在 VS Code 或 JetBrains IDE 中開啟儲存庫 Copilot 會自動載入 .github/copilot-instructions.md

通用存取（任何 AI）

1. 複製提示詞：cat prompts/stock-valuation.md | pbcopy
2. 貼入 ChatGPT、Claude.ai 或任何大型語言模型
3. 提問分析

🎓 範例工作流程

工作流程 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 的差異化優勢

📊 專案狀態

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

🤝 貢獻

添加新技能

詳見 ADDING-NEW-SKILLS.md 完整指南：

• 12 步驟說明
• 檔案結構範本
• 平台同步檢查清單
• 測試程序

回報問題

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

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

⚖️ 法律聲明

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

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

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

過去績效不代表未來結果