# InvestSkill 操作手冊

InvestSkill 的實用範例、安裝指南與核心概念。

📖 English | 繁體中文

---

# 目錄

1. 安裝指南
2. 核心概念
3. 示範範例與輸出結果
   • 股票綜合評估
   • DCF 估值分析
   • 財報分析
   • 完整研究包
   • 技術分析
4. 跨 AI 工具使用
5. 技巧與最佳實踐

---

# 1. 安裝指南

# 前置需求

• 已安裝 Claude Code（npm install -g @anthropic-ai/claude-code）
• 有效的 Anthropic API 金鑰

# 安裝 InvestSkill（約 2 分鐘）

# 步驟 1：開啟 Claude Code
claude

# 步驟 2：加入外掛市集
/plugin marketplace add yennanliu/InvestSkill

# 步驟 3：安裝外掛
/plugin install us-stock-analysis@invest-skill

# 步驟 4：確認安裝
/plugin list

確認在清單中看到 us-stock-analysis，並顯示 18 個可用技能，即表示安裝成功。

# 快速測試

# 用一支你熟悉的股票測試
/us-stock-analysis:stock-eval AAPL

若看到含有 BULLISH/NEUTRAL/BEARISH 訊號區塊的分析輸出，即表示已準備就緒。

# 本地開發環境設定

# 複製儲存庫
git clone https://github.com/yennanliu/InvestSkill.git
cd InvestSkill

# 在專案目錄開啟 Claude Code
claude

# 加入本地市集（請替換為實際路徑）
/plugin marketplace add /path/to/InvestSkill

# 從本地來源安裝
/plugin install us-stock-analysis@invest-skill

# 更新至最新版本

# 移除現有安裝
/plugin uninstall us-stock-analysis

# 重新加入市集（刷新至最新版本）
/plugin marketplace add yennanliu/InvestSkill

# 重新安裝
/plugin install us-stock-analysis@invest-skill

---

# 2. 核心概念

# InvestSkill 是什麼

InvestSkill 是一套結構化分析提示框架，以 Claude Code 外掛的形式打包。每個技能（Skill）都是詳細的指令集，告訴 Claude Code 如何分析股票、解讀財務數據，並以一致的格式呈現分析結果。

把每個技能想像成一位可以隨時呼叫的專業分析師：

指令	功能說明
/stock-eval AAPL	全方位評估：質量、估值、護城河、風險
/dcf-valuation NVDA	嚴謹的內在價值模型，含 3 種情境分析
/stock-valuation MSFT	多方法估值：DCF + 比較公司分析 + EV 倍數
/financial-report-analyst GOOGL 10-K	深度閱讀年報，找出紅旗警訊
/research-bundle TSLA	依序執行所有技能，整合成完整投資論點

# 技能如何運作

每個技能由一個 SKILL.md 檔案定義，包含：

1. 描述（frontmatter）：外掛系統使用的單行摘要
2. 方法論：含表格、評分與公式的逐步分析框架
3. 輸出格式：Claude Code 遵循的標準化章節
4. 訊號區塊：每次分析結尾必備

plugins/us-stock-analysis/skills/
├── stock-eval/SKILL.md
├── dcf-valuation/SKILL.md
├── stock-valuation/SKILL.md        ← v1.3.0 新增
├── financial-report-analyst/SKILL.md  ← v1.3.0 新增
└── ...（共 18 個技能）

# 標準訊號區塊

每次 InvestSkill 分析結尾都有標準化訊號區塊，方便快速決策：

╔══════════════════════════════════════════════╗
║              INVESTMENT SIGNAL               ║
╠══════════════════════════════════════════════╣
║ Signal:      BULLISH / NEUTRAL / BEARISH     ║
║ Confidence:  HIGH / MEDIUM / LOW             ║
║ Horizon:     SHORT / MEDIUM / LONG-TERM      ║
║ Score:       X.X / 10                        ║
╠══════════════════════════════════════════════╣
║ Action:      BUY / HOLD / SELL               ║
║ Conviction:  STRONG / MODERATE / WEAK        ║
╚══════════════════════════════════════════════╝

評分說明：

• 8.0–10.0 → 強烈看漲
• 6.0–7.9 → 溫和看漲
• 4.0–5.9 → 中性
• 2.0–3.9 → 溫和看跌
• 0.0–1.9 → 強烈看跌

# 通用提示（跨 AI 相容）

每個技能也以獨立提示檔案的形式存放在 prompts/ 目錄中。這些檔案適用於任何 AI 工具——不限於 Claude Code：

prompts/
├── stock-eval.md
├── dcf-valuation.md
├── stock-valuation.md
├── financial-report-analyst.md
└── ...（共 17 個檔案）

只需將檔案內容複製貼上到任何 AI 對話作為系統提示即可使用。

---

# 3. 示範範例與輸出結果

注意：以下輸出為代表性範例，展示分析的格式與深度。實際輸出會使用即時數據，結果會有所不同。

# 3.1 股票綜合評估

指令：

/us-stock-analysis:stock-eval MSFT

範例輸出：

# 股票評估 — MSFT（微軟公司）

## 公司概況
微軟擁有三大主要業務部門：
- 智慧雲端（Azure、伺服器產品）：佔營收 43%，成長最快
- 生產力與商業流程（Office 365、LinkedIn、Dynamics）：32%
- 個人電腦（Windows、Xbox、Surface）：25%

護城河：Azure 平台鎖定效應、Office 365 訂閱黏性、企業客戶關係。
各部門的轉換成本均極高。

## 財務健康狀況

營收成長（5 年 CAGR）：15.8%
毛利率：          70.1%  （擴張：年增 180 bps）
營業利益率：      44.6%  （擴張：年增 120 bps）
自由現金流利潤率：37.2%
淨現金部位：      274 億美元（淨現金——堅固的資產負債表）

## 估值指標

| 指標       | 當前    | 1年前   | 5年均值 | 同業均值 |
|------------|---------|---------|---------|---------|
| P/E（預期）| 32.4x   | 28.1x   | 30.2x   | 26.8x   |
| EV/EBITDA  | 24.1x   | 21.5x   | 22.8x   | 18.4x   |
| EV/FCF     | 41.2x   | 37.8x   | 36.5x   | 28.1x   |
| 市銷率     | 12.8x   | 10.9x   | 11.6x   | 7.2x    |

溢價合理性：優越的利潤率、雲端成長軌跡、AI 潛力（Copilot、Azure OpenAI）。

## 質量評分

Piotroski F 評分：  8/9   （強——僅在流通股方面未達標）
資本投入回報率：    28.4%
加權資本成本（估算）：8.9%
ROIC − WACC 利差：  +1,950 bps（顯著的價值創造）

## DCF 快速估值範圍

基本情境內在價值：  385–420 美元/股
悲觀情境內在價值：  295–320 美元/股
樂觀情境內在價值：  480–530 美元/股
當前股價：          422.14 美元
安全邊際（基本）：  合理估值——略高於基本情境

╔══════════════════════════════════════════════╗
║              INVESTMENT SIGNAL               ║
╠══════════════════════════════════════════════╣
║ Signal:      BULLISH（看漲）                  ║
║ Confidence:  MEDIUM（中等）                   ║
║ Horizon:     LONG-TERM（長期）                ║
║ Score:       7.2 / 10                        ║
╠══════════════════════════════════════════════╣
║ Action:      BUY（買進）                      ║
║ Conviction:  MODERATE（溫和）                 ║
╚══════════════════════════════════════════════╝

---

# 3.2 DCF 估值分析

指令：

/us-stock-analysis:dcf-valuation NVDA --scenarios

範例輸出（精簡版）：

# DCF 估值 — NVDA（輝達公司）

## 基本指標（過去 12 個月）
營收：    1,220 億美元    自由現金流：608 億美元
FCF 利潤率：49.8%          淨現金：   385 億美元
股票薪酬：35 億美元        真實 FCF*：573 億美元（扣除股票薪酬後）
流通股數：244 億股

## 加權資本成本計算
股權成本：無風險利率 4.4% + β 1.72 × 股權風險溢價 5.5% = 13.9%
稅後債務成本：1.6%
資本結構：股權 99.2% / 債務 0.8%
WACC：13.8%

## 情境假設

| 情境 | 機率 | 第1-5年營收CAGR | 第6-10年營收CAGR | 第10年FCF利潤率 | 終端成長率 |
|------|------|-----------------|-----------------|-----------------|------------|
| 樂觀 | 20%  | 42%             | 18%             | 48%             | 3.0%       |
| 基本 | 60%  | 28%             | 10%             | 40%             | 2.5%       |
| 悲觀 | 20%  | 12%             | 5%              | 28%             | 1.5%       |

## 內在價值結果

| 情境 | 每股內在價值 | 相對當前價（875美元） | 安全邊際 |
|------|-------------|----------------------|---------|
| 樂觀 | 1,240 美元  | +41.7%               | 折價    |
| 基本 | 785 美元    | −10.3%               | 溢價    |
| 悲觀 | 320 美元    | −63.4%               | 溢價    |
| 加權 | 768 美元    | −12.2%               | 溢價    |

## 敏感度分析表（基本情境，每股美元）

              終端成長率
WACC     1.5%    2.0%    2.5%    3.0%    3.5%
11.0%    $910    $960   $1,020  $1,090  $1,180
12.0%    $830    $875    $920    $975   $1,040
13.8%    $710    $745    $785    $825    $875  ← 基本情境
15.0%    $625    $655    $685    $720    $760
16.0%    $570    $595    $620    $650    $685

## 評估結論
以當前股價 875 美元計，NVDA 比基本情境內在價值溢價約 12%。
樂觀情境需要：AI 資本支出週期持續 5 年以上，市場份額維持。
悲觀情境風險：雲端客戶消化期、AMD MI300X 競爭、客製晶片。

╔══════════════════════════════════════════════╗
║              INVESTMENT SIGNAL               ║
╠══════════════════════════════════════════════╣
║ Signal:      NEUTRAL（中性）                  ║
║ Confidence:  MEDIUM（中等）                   ║
║ Horizon:     LONG-TERM（長期）                ║
║ Score:       5.8 / 10                        ║
╠══════════════════════════════════════════════╣
║ Action:      HOLD（持有）                     ║
║ Conviction:  MODERATE（溫和）                 ║
╚══════════════════════════════════════════════╝

---

# 3.3 財報分析

指令：

/us-stock-analysis:financial-report-analyst AAPL 10-K --section md&a

範例輸出（精簡版）：

# 財報分析 — AAPL 10-K（FY2024）

## 文件基本資訊
申報類型：   10-K 年度報告（截至 2024 年 9 月 28 日）
核數師：     安永會計師事務所 — 無保留意見
申報日期：   2024 年 10 月 25 日（準時）
重編：       無

## 財務健康儀表板
┌──────────────────────┬──────────────────────────────────────┐
│ 營收成長              │ +2.0% 年增（3,910 億美元）             │
│ 毛利率                │ 46.2%（前年 44.1%，+210 bps）          │
│ 營業利益率            │ 31.5%（前年 29.8%，+170 bps）          │
│ FCF 利潤率            │ 27.8%（轉換率：108%）                  │
│ 淨現金                │ 545 億美元（負債/EBITDA：0.7x）         │
│ 應收帳款天數（DSO）   │ 26.1 天（前年：27.8 天）               │
│ 管理層態度            │ 正面——對服務部門充滿信心               │
├──────────────────────┼──────────────────────────────────────┤
│ 申報質量評分          │ 9.2 / 10                             │
│ 盈利質量評分          │ 8.8 / 10                             │
│ 資產負債表評分        │ 9.5 / 10                             │
└──────────────────────┴──────────────────────────────────────┘

## 主要正面因素（看漲訊號）
• 服務部門達 962 億美元（年增 13%）——循環、高利潤率的收入流持續增長，
  結構性提升整體利潤率
• 毛利率年增 210 bps——有利的產品組合（iPhone Pro 佔比提升、服務部門）
• FCF 轉換率 >100%——高質量盈利，營運資金幾乎無拖累
• DSO 改善 1.7 天——健康的應收帳款管理
• Apple Intelligence（AI）在 MD&A 中出現 47 次——生態系統鎖定效應明確

## 主要負面因素 / 紅旗警訊
• 中國營收下滑 8%（669 億美元）——地緣政治與本地競爭風險（風險：高）
• iPad 與 Mac 部門均年減——硬體升級週期延長（風險：中）
• 歐盟《數位市場法》合規成本及強制開放 App Store——結構性利潤率風險（風險：中）
• 股票薪酬 117 億美元（佔營收 3.0%）——偏高但可控（風險：低）

## 風險因素變化（相較前次 10-K）
新增風險：
  1. 人工智慧監管——歐盟 AI 法規合規
  2. 數位市場法——歐盟強制開放第三方應用商店

升級風險：
  1. 中國競爭——華為 Mate 系列復甦顯著；措辭明顯強化
  2. App Store 反壟斷——新增美國司法部調查相關內容

╔══════════════════════════════════════════════╗
║              INVESTMENT SIGNAL               ║
╠══════════════════════════════════════════════╣
║ Signal:      BULLISH（看漲）                  ║
║ Confidence:  HIGH（高）                       ║
║ Horizon:     LONG-TERM（長期）                ║
║ Score:       7.8 / 10                        ║
╠══════════════════════════════════════════════╣
║ Action:      BUY（買進）                      ║
║ Conviction:  MODERATE（溫和）                 ║
╚══════════════════════════════════════════════╝

---

# 3.4 完整研究包

指令：

/us-stock-analysis:research-bundle AMZN

範例輸出（精簡版）：

# 研究包 — AMZN（亞馬遜公司）

## 第一階段：商業質量評估
競爭分析：經濟護城河 = 寬廣（評分：8.5/10）
  - AWS：31% 雲端市場份額，37% 營業利益率，高轉換成本
  - Prime 生態系統：2 億+ 訂戶，飛輪效應創造結構性優勢
  - 廣告：500 億+ 美元業務，年增 20%+，最高利潤率業務
基本面分析：財務強度 = 7.8/10
  - 營收：5,900 億美元 | 自由現金流：540 億美元（FCF 利潤率 9.1%，快速擴張中）
  - 淨現金 470 億美元，提供充分的策略靈活性

商業質量評分：8.1/10 → 優秀

## 第二階段：估值評估
DCF 基本情境內在價值：208 美元/股 | 當前：224 美元 | 溢價：7.7%
股票評估比較：P/E 37x（預期），EV/EBITDA 21x——與同業接近
目標價範圍：195 美元（悲觀）— 224 美元（基本）— 275 美元（樂觀）
估值評分：6.2/10 → 合理估值，略有溢價

## 第三階段：市場訊號
內部人士：CEO Andy Jassy 無公開市場買入；常規 10b5-1 計畫賣出
機構：13F 數據顯示 Vanguard/BlackRock 持續加倉；第三季淨流入
財報電話會議：管理層態度積極；強調 AWS 加速；
             給出具體指引：下季營收成長 +8-10%
市場訊號評分：7.5/10 → 正面

## 第四階段：技術面設定
股價在 50 日與 200 日均線上方；近期突破整理區間
RSI：58（中性動能，未過熱）
支撐位：205 美元 | 阻力位：240 美元
成交量：可見積累形態
技術面設定：中等 → 6.0/10

## 第五階段：風險評估
空頭持倉比率：1.9%——空頭興趣極低
選擇權：隱含波動率 31%（接近一年低點——市場過於樂觀）
風險等級：低 → 評分：8.0/10

## 綜合評分卡

| 組成部分   | 權重 | 子評分 | 貢獻 |
|------------|------|--------|------|
| 商業質量   | 25%  | 8.1    | 2.03 |
| 估值       | 25%  | 6.2    | 1.55 |
| 市場訊號   | 20%  | 7.5    | 1.50 |
| 技術面設定 | 15%  | 6.0    | 0.90 |
| 風險等級   | 15%  | 8.0    | 1.20 |
| 綜合       | 100% | 7.18/10|      |

**解讀：買進（多數訊號正面，合理進場點）**

## 投資論點
亞馬遜的 AWS 復甦（重新加速至 19% 成長率）加上擴張中的高利潤廣告業務，
在未來 3 年將創造強大的盈利槓桿效應。零售部門長期作為拖累項，
隨著履約優化成熟，正在向獲利方向轉折。AWS 的營業利益本身，
以合理的估值倍數計算，足以支撐當前的企業價值。

## 進場策略
理想進場：205–215 美元（回調至關鍵支撐區）
當前進場（224 美元）：長期投資者可接受；若可能，等待更佳機會
倉位大小：高信念長期持有，建議佔投資組合 3–5%

╔══════════════════════════════════════════════╗
║              INVESTMENT SIGNAL               ║
╠══════════════════════════════════════════════╣
║ Signal:      BULLISH（看漲）                  ║
║ Confidence:  MEDIUM（中等）                   ║
║ Horizon:     LONG-TERM（長期）                ║
║ Score:       7.2 / 10                        ║
╠══════════════════════════════════════════════╣
║ Action:      BUY（買進）                      ║
║ Conviction:  MODERATE（溫和）                 ║
╚══════════════════════════════════════════════╝

---

# 3.5 技術分析

指令：

/us-stock-analysis:technical-analysis TSLA --chart

範例輸出（精簡版）：

# 技術分析 — TSLA（特斯拉公司）

## 趨勢分析
主要趨勢：    空頭（股價在 200 日均線下方）
次要趨勢：    中性（在 50 日均線上方整理）
短期趨勢：    多頭（股價重回 20 日均線，RSI 回升中）
多時間框架對齊：混合 → 謹慎操作

## 關鍵價位
支撐 1：195 美元——強支撐（測試 4 次，積累區間）
支撐 2：175 美元——強支撐（多年需求水位）
阻力 1：240 美元——強阻力（前期跌破點，現為頭頂賣壓）
阻力 2：265 美元——中等（50 週均線）
52 週區間：138.80（低）—— 299.29（高）

## 指標訊號

| 指標       | 數值   | 訊號 | 備註                         |
|------------|--------|------|------------------------------|
| RSI（14）  | 48.2   | 中性 | 中位值，從超賣回升中          |
| MACD       | −2.1   | 中性 | 交叉待確認，直方圖收窄中      |
| 布林通道   | 中軌   | 中性 | 股價在中軌，帶寬收窄          |
| 成交量     | 低於均值| 中性 | 反彈時成交量萎縮（訊號偏弱）  |
| OBV        | 下降中 | 空頭 | 可見分配形態                  |
| 隨機指標   | 42     | 中性 | 中位值，無明確訊號            |

## 型態識別
潛在型態：下降三角形（空頭延續）
頸線：195 美元——若跌破，目標約 155 美元
替代情境：若 195 美元守住，240 美元突破，則形成倒頭肩（多頭）

## 交易設定
保守進場：197–202 美元（支撐位附近，量能確認）
停損：188 美元（跌破支撐——論點失效）
目標 1：240 美元（阻力）   風險報酬：1:3.5
目標 2：265 美元（延伸）   風險報酬：1:6.0
時間框架：波段交易（4–8 週）

╔══════════════════════════════════════════════╗
║              INVESTMENT SIGNAL               ║
╠══════════════════════════════════════════════╣
║ Signal:      NEUTRAL（中性）                  ║
║ Confidence:  LOW（低）                        ║
║ Horizon:     SHORT-TERM（短期）               ║
║ Score:       4.5 / 10                        ║
╠══════════════════════════════════════════════╣
║ Action:      HOLD（持有）                     ║
║ Conviction:  WEAK（弱）                       ║
╚══════════════════════════════════════════════╝

---

# 4. 跨 AI 工具使用

InvestSkill 適用於任何 AI 助手。prompts/ 目錄包含所有 17 個分析框架的獨立檔案。

# Gemini CLI

# GEMINI.md 會被 Gemini CLI 自動載入
cd /path/to/InvestSkill
gemini

# 直接引用提示檔案
> @prompts/stock-valuation.md 使用所有估值方法分析 AAPL

# 貼上 10-K 章節進行分析
> @prompts/financial-report-analyst.md
> [在此貼上 10-K 文字]

# GitHub Copilot

.github/copilot-instructions.md 檔案會自動載入為工作區脈絡。

# 在 Copilot Chat（VSCode 或 github.com）
使用 stock-valuation 框架分析 NVDA

# 引用特定提示
使用 @workspace /prompts/dcf-valuation.md 中的框架估算 MSFT 的價值

# Cursor

.cursor/rules/invest-skill.mdc 檔案會在 Cursor 中自動套用。

# Cursor AI 對話
@prompts/fundamental-analysis.md 分析 GOOGL 的財務報表

# 或直接詢問——Cursor 會套用框架
使用 InvestSkill 方法論對 AMZN 進行 DCF 估值

# 任何 AI（ChatGPT、Claude.ai 等）

# 1. 複製任何提示檔案的內容
cat prompts/stock-eval.md | pbcopy   # macOS

# 2. 貼上到任何 AI 對話作為系統提示或對話開頭

# 3. 詢問問題
「使用這個框架分析 AAPL」

---

# 5. 技巧與最佳實踐

# 獲得更佳結果

明確指定公司與脈絡：

# 良好
/stock-eval NVDA                    # 明確的股票代碼
/dcf-valuation MSFT --scenarios     # 加上旗標取得更豐富輸出
/research-bundle AAPL --visual      # 用於報告生成的視覺輸出

# 更好——加入上下文
/financial-report-analyst AAPL      # 然後貼上實際的 10-K 文字

使用 --visual 進行報告生成：

/fundamental-analysis NVDA --visual
# 然後輸入報告產生器：
/report-generator --type comprehensive

串接技能進行深度分析：

# 步驟 1：取得基本面
/fundamental-analysis MSFT

# 步驟 2：估算企業價值
/dcf-valuation MSFT --scenarios

# 步驟 3：檢視競爭定位
/competitor-analysis MSFT

# 步驟 4：或一次執行所有分析
/research-bundle MSFT

# 選擇正確的技能

你的問題	最適合的技能
「這支股票便宜還是貴？」	/dcf-valuation + /stock-valuation
「這是好的企業嗎？」	/stock-eval + /competitor-analysis
「這份財報裡有什麼？」	/financial-report-analyst
「內部人士在做什麼？」	/insider-trading
「這個股息安全嗎？」	/dividend-analysis
「股票目前技術面如何？」	/technical-analysis
「投資前的完整盡職調查」	/research-bundle
「這支股票有軋空潛力嗎？」	/short-interest

# 解讀訊號評分

0–10 分的評分是一個綜合指標，應作為其中一項輸入，而非最終答案：

• 8 分以上：強烈信念。多數訊號一致。仍需風險管理。
• 6–8 分：中等信念。多數正面，略有疑慮。適合正常倉位大小。
• 4–6 分：中性。訊號混雜。考慮等待更清晰的訊號或縮小倉位。
• 2–4 分：偏空趨勢。負面因素多於正面。避免新建多頭倉位。
• 2 分以下：強烈看空。多個紅旗警訊。考慮迴避或對沖。

# 搭配真實財務數據使用

為獲得最佳結果，請提供 AI 實際數據：

1. 貼上財務報表（來自公司投資人關係頁面）
2. 附上 10-K/10-Q PDF，使用 financial-report-analyst 技能時
3. 提供具體數字（營收、利潤率、股數）以提高 DCF 準確性
4. 引用財報電話會議逐字稿搭配 earnings-call-analysis 技能

---

# 免責聲明

InvestSkill 僅提供教育性分析框架。本專案中的任何內容均不構成財務建議。所有輸出均為基於技能中嵌入方法論的 AI 生成分析——並非未來績效的保證。在做出投資決策前，請務必諮詢合格的財務顧問。