Communitygithub.com

leecyno1/boutique-skills

透過整合 Alpaca MCP Server 擷取持股和部位,進行全面的投資組合分析,包括資產配置、風險指標、個股部位、分散程度評估,並產生再平衡建議。當使用者要求檢視其證券帳戶的投資組合、部位分析、風險評估、績效評價或再平衡建議時使用。

boutique-skills 是什麼?

這個 AI 代理技能,名為「投資組合經理」,專門用於分析和管理投資組合。它與 Alpaca MCP 伺服器整合,可即時擷取真實的經紀帳戶資料,包括所有當前持股、帳戶權益、現金餘額與歷史績效。技能的核心價值在於提供以數據驅動的全面分析,涵蓋資產配置、分散程度、風險指標及個股評估,最終產出可執行的再平衡建議。此技能特別適合需要深入投資組合審查的使用者,例如要求「分析我的投資組合」、「檢查風險」或「是否該重新平衡?」等情境。工作流程遵循六個步驟:首先透過 Alpaca MCP 取得資料,然後為每個持股補充市場與基本面資訊,接著執行投資組合層級的分析(資產配置、分散程度、風險、績效),再對前十大持股進行個別評估,最後根據偏離目標權重的情況生成優先排序的再平衡計畫。所有分析都基於標準的金融框架,並產出詳細的 Markdown 報告。支援 Claude Code 等透過 MCP 整合的工具,但前提是必須先設定好 Alpaca MCP 伺服器。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/leecyno1/boutique-skills/tree/HEAD/skills/default/portfolio-manager

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

投資組合經理

概述

透過與 Alpaca MCP 伺服器整合,擷取即時持股資料,進行全面的投資組合分析,涵蓋資產配置、分散程度、風險指標、個別部位評估及再平衡建議。產生具有可行洞察的詳細投資組合報告。

此技能利用 Alpaca 的經紀 API,透過 MCP(模型上下文協定)存取即時投資組合資料,確保分析基於實際的當前部位,而非手動輸入的資料。

使用時機

當使用者提出以下要求時,呼叫此技能:

  • 「分析我的投資組合」
  • 「審查我的當前部位」
  • 「我的資產配置是什麼?」
  • 「檢查我的投資組合風險」
  • 「我應該重新平衡我的投資組合嗎?」
  • 「評估我的持股」
  • 「投資組合績效審查」
  • 「我應該買入或賣出哪些股票?」
  • 任何涉及投資組合層級分析或管理的要求

先決條件

Alpaca MCP 伺服器設定

此技能需要在設定並連接 Alpaca MCP 伺服器後才能使用。該 MCP 伺服器提供以下資訊的存取:

  • 當前投資組合部位
  • 帳戶權益與購買力
  • 歷史部位與交易
  • 已持有證券的市場數據

使用的 MCP 伺服器工具:

  • get_account_info - 擷取帳戶權益、購買力、現金餘額
  • get_positions - 擷取所有當前部位,包含數量、成本基礎、市值
  • get_portfolio_history - 歷史投資組合績效數據
  • 用於報價與基本面的市場數據工具

若 Alpaca MCP 伺服器未連接,請通知使用者,並提供 references/alpaca_mcp_setup.md 中的設定說明。

工作流程

步驟 1:透過 Alpaca MCP 擷取投資組合資料

使用 Alpaca MCP 伺服器工具收集當前投資組合資訊:

1.1 取得帳戶資訊:

使用 mcp__alpaca__get_account_info 擷取:
- 帳戶權益(投資組合總值)
- 現金餘額
- 購買力
- 帳戶狀態

1.2 取得當前部位:

使用 mcp__alpaca__get_positions 擷取所有持股:
- 股票代號
- 持有數量
- 平均進場價格(成本基礎)
- 當前市價
- 當前市值
- 未實現損益(金額與百分比)
- 部位占投資組合的百分比

1.3 取得投資組合歷史(選擇性):

使用 mcp__alpaca__get_portfolio_history 進行績效分析:
- 歷史權益價值
- 時間加權報酬率計算
- 回撤分析

資料驗證:

  • 確認所有部位都有有效的股票代號
  • 確認市值總和約等於帳戶權益
  • 檢查是否有過時或無效的部位
  • 處理邊緣情況(碎股、選擇權、加密貨幣,若有支援)

步驟 2:擴充部位資料

針對投資組合中的每個部位,收集額外的市場數據與基本面資料:

2.1 當前市場數據:

  • 即時或延遲的價格報價
  • 每日成交量與流動性指標
  • 52 週價格範圍
  • 市值

2.2 基本面資料: 使用 WebSearch 或可用的市場資料 API 擷取:

  • 行業與產業分類
  • 關鍵估值指標(本益比、股價淨值比、殖利率)
  • 近期財報與財務健康指標
  • 分析師評級與目標價
  • 近期新聞與重大發展

2.3 技術分析:

  • 價格趨勢(20 日、50 日、200 日移動平均線)
  • 相對強弱
  • 支撐與壓力位
  • 動能指標(RSI、MACD,若有資料)

步驟 3:投資組合層級分析

使用參考檔案中的框架進行全面投資組合分析:

3.1 資產配置分析

閱讀 references/asset-allocation.md 了解配置框架

從多個面向分析當前配置:

依資產類別:

  • 股票 vs 固定收益 vs 現金 vs 另類投資
  • 比較與使用者風險承受度對應的目標配置
  • 評估配置是否符合投資目標

依產業別:

  • 科技、醫療保健、金融、消費品等
  • 辨識產業集中度風險
  • 比較與基準指數(如 S&P 500)的產業權重

依市值:

  • 大型股 vs 中型股 vs 小型股分布
  • 對超級大盤股的集中程度
  • 市值分散程度評分

依地理區域:

  • 美國 vs 國際 vs 新興市場
  • 國內集中度風險評估

輸出格式:

## 資產配置

### 當前配置 vs 目標
| 資產類別 | 當前 | 目標 | 差異 |
|-------------|---------|--------|----------|
| 美國股票 | XX.X% | YY.Y% | +/- Z.Z% |
| ... |

### 產業分布
[長條圖描述或包含產業百分比的表格]

### 前十大持股
| 排名 | 代號 | 占投資組合比例 | 產業 |
|------|--------|----------------|--------|
| 1 | AAPL | X.X% | 科技 |
| ... |

3.2 分散程度分析

閱讀 references/diversification-principles.md 了解分散投資理論

評估投資組合分散程度品質:

部位集中度:

  • 辨識前幾大持股及其總權重
  • 若任何單一部位超過投資組合的 10-15%,則發出標記
  • 計算赫芬達爾-赫希曼指數(HHI)來衡量集中度

產業集中度:

  • 辨識主導產業
  • 若任何產業超過投資組合的 30-40%,則發出標記
  • 比較與基準指數的產業多樣性

相關性分析:

  • 估算主要部位之間的相關性
  • 辨識高度相關的持股(可能的重複部位)
  • 評估真正的分散投資效益

部位數量:

  • 個股投資組合的最佳範圍:15-30 檔股票
  • 若過度集中(少於 10 檔股票)或過度分散(超過 50 檔股票),則發出標記

輸出:

## 分散程度評估

**集中度風險:** [低 / 中 / 高]
- 前五大持股占投資組合的 XX%
- 最大單一部位:[代號] 占 XX%

**產業分散程度:** [極佳 / 良好 / 普通 / 不佳]
- 主導產業:[產業名稱] 占 XX%
- [對各產業平衡狀況的評估]

**部位數量:** [最佳 / 過度集中 / 過度分散]
- 總部位數:XX 檔股票
- [建議]

**相關性顧慮:**
- [列出任何高度相關的部位配對]
- [改善分散程度的建議]

3.3 風險分析

閱讀 references/portfolio-risk-metrics.md 了解風險衡量框架

計算並解讀關鍵風險指標:

波動性衡量:

  • 投資組合估計 Beta(各部位 Beta 的加權平均)
  • 個別部位波動性
  • 投資組合標準差(若有歷史資料)

下行風險:

  • 最大回撤(來自投資組合歷史)
  • 當前回撤(距歷史高點)
  • 有重大未實現損失的部位

風險集中度:

  • 高波動性股票(Beta > 1.5)的百分比
  • 投機性/虧損公司的百分比
  • 槓桿使用情況(若適用)

尾部風險:

  • 潛在黑天鵝事件的曝險程度
  • 單一股票集中度風險
  • 特定產業的事件風險

輸出:

## 風險評估

**整體風險輪廓:** [保守 / 穩健 / 積極]

**投資組合 Beta:** X.XX(對比市場的 1.00)
- 解讀:投資組合波動性 [高於 / 低於] 市場

**最大回撤:** -XX.X%(從 $XXX,XXX 降至 $XXX,XXX)
- 當前自高點回撤:-XX.X%

**高風險部位:**
| 代號 | 占投資組合比例 | Beta | 風險因子 |
|--------|----------------|------|-------------|
| [TICKER] | XX% | X.XX | [高波動性 / 近期虧損 / 其他] |

**風險集中情形:**
- XX% 集中於單一產業([產業])
- XX% 位於 Beta > 1.5 的股票
- [其他集中度風險]

**風險評分:** XX/100([低 / 中 / 高] 風險)

3.4 績效分析

使用可用資料評估投資組合績效:

絕對報酬:

  • 整體投資組合未實現損益(金額與百分比)
  • 表現最佳部位(前 5 名,依上漲百分比)
  • 表現最差部位(後 5 名,依下跌百分比)

時間加權報酬(若有歷史資料):

  • 年初至今報酬率
  • 1 年、3 年、5 年年化報酬率
  • 比較與基準指數(S&P 500、相關指數)

部位層級績效:

  • 贏家 vs 輸家比例
  • 獲利部位的平均漲幅
  • 虧損部位的平均跌幅
  • 接近 52 週高點/低點的部位

輸出:

## 績效審查

**投資組合總值:** $XXX,XXX
**未實現損益總額:** $XX,XXX(+XX.X%)
**現金餘額:** $XX,XXX(占投資組合 XX%)

**最佳表現者:**
| 代號 | 漲幅 | 部位價值 |
|--------|------|----------------|
| [TICKER] | +XX.X% | $XX,XXX |
| ... |

**最差表現者:**
| 代號 | 跌幅 | 部位價值 |
|--------|------|----------------|
| [TICKER] | -XX.X% | $XX,XXX |
| ... |

**相對於基準指數的表現(若有資料):**
- 投資組合報酬率:+X.X%
- S&P 500 報酬率:+Y.Y%
- Alpha:+/- Z.Z%

步驟 4:個別部位分析

針對關鍵部位(依投資組合權重排序的前 10-15 名),進行詳細分析:

閱讀 references/position-evaluation.md 了解部位分析框架

對每個重要部位進行:

4.1 當前投資論點驗證:

  • 建立此部位的原因為何?(若從使用者背景得知)
  • 投資論點已實現或失效?
  • 近期公司發展與新聞

4.2 估值評估:

  • 當前估值指標(本益比、股價淨值比等)
  • 比較與歷史估值區間
  • 比較與產業同行
  • 高估 / 合理 / 低估 評估

4.3 技術面健康度:

  • 價格趨勢(上升、下降、橫盤)
  • 價格相對於移動平均線的位置
  • 支撐與壓力位
  • 動能狀態

4.4 部位規模:

  • 在投資組合中的當前權重
  • 考量信心程度與風險,此規模是否適當?
  • 與最佳規模相比是超重或低配?

4.5 行動建議:

  • 持有 - 部位規模適中且論點完好
  • 加碼 - 考量機會低配,論點增強中
  • 減碼 - 超重或估值偏高
  • 賣出 - 論點失效,其他機會更好

每個部位的輸出:

### [代號] - [公司名稱](占投資組合 XX.X%)

**部位詳情:**
- 股數:XXX
- 平均成本:$XX.XX
- 當前價格:$XX.XX
- 市值:$XX,XXX
- 未實現損益:$X,XXX(+XX.X%)

**基本面快照:**
- 產業:[產業]
- 市值:$XX.XB
- 本益比:XX.X | 殖利率:X.X%
- 近期發展:[關鍵新聞或財報]

**技術面狀態:**
- 趨勢:[上升 / 下降 / 橫盤]
- 價格 vs 50日均線:[高於 / 低於] XX%
- 支撐:$XX.XX | 壓力:$XX.XX

**部位評估:**
- **論點狀態:** [完好 / 減弱 / 失效 / 增強]
- **估值:** [低估 / 合理 / 高估]
- **部位規模:** [最佳 / 超重 / 低配]

**建議:** [持有 / 加碼 / 減碼 / 賣出]
**理由:** [1-2 句說明]

步驟 5:再平衡建議

閱讀 references/rebalancing-strategies.md 了解再平衡方法

產生具體的再平衡建議:

5.1 辨識再平衡觸發條件:

  • 顯著偏離目標權重的部位
  • 需要調整的產業/資產類別配置
  • 應減碼的超重部位(超過門檻)
  • 應加碼的低配領域(低於門檻)
  • 稅務考量(資本利得影響)

5.2 制定再平衡計畫:

應減碼的部位:

  • 超重部位(偏離目標超過門檻)
  • 大幅上漲的股票(估值考量)
  • 超過投資組合 15-20% 的集中部位
  • 論點已失效的部位

應加碼的部位:

  • 低配的產業或資產類別
  • 目前低配但高度確信的部位
  • 可改善分散程度的新機會

現金部署:

  • 若有超額現金(> 投資組合 10%),建議部署
  • 根據機會與配置缺口進行優先排序

5.3 優先排序: 將再平衡行動按優先級排序:

  1. 立即 - 風險降低(減碼集中部位)
  2. 高優先 - 重大配置偏離(偏離目標 > 10%)
  3. 中優先 - 中度偏離(偏離目標 5-10%)
  4. 低優先 - 微調與機會性調整

輸出:

## 再平衡建議

### 摘要
- **是否需要再平衡:** [是 / 否 / 選擇性]
- **主要原因:** [集中度風險 / 產業偏離 / 現金部署 / 其他]
- **估計交易數:** X 筆賣單,Y 筆買單

### 建議行動

#### 高優先:風險降低
**減碼 [代號]** 從 XX% 降至投資組合的 YY%
- **應賣出股數:** XX 股(約 $XX,XXX)
- **理由:** [超重 / 估值過高 / 其他]
- **稅務影響:** 估計資本利得 $X,XXX

#### 中優先:資產配置
**增加 [產業/資產類別]** 曝險
- **目標:** 從 XX% 增加至 YY%
- **建議股票:** [代號1, 代號2, 代號3]
- **投資金額:** 約 $XX,XXX

#### 現金部署
**當前現金:** $XX,XXX(占投資組合 XX%)
- **建議:** [部署 / 保留以備機會 / 降低至 X%]
- **建議配置:** [分配至各產業/股票]

### 實施計畫
1. [第一個行動 - 最高優先級]
2. [第二個行動]
3. [第三個行動]
...

**時機考量:**
- [稅務年度規劃 / 財報季 / 市場狀況]
- [若適用,建議分階段執行]

步驟 6:產生投資組合報告

建立全面的 Markdown 報告並儲存至儲存庫根目錄:

檔案名稱: portfolio_analysis_YYYY-MM-DD.md

報告結構:

# 投資組合分析報告

**帳戶:** [若有,提供帳戶類型]
**報告日期:** YYYY-MM-DD
**投資組合價值:** $XXX,XXX
**總損益:** $XX,XXX(+XX.X%)

---

## 執行摘要

[3-5 個要點總結主要發現]
- 整體投資組合健康度評估
- 主要優勢
- 主要風險或疑慮
- 首要建議

---

## 持股概覽

[所有部位的摘要表格]

---

## 資產配置

[來自步驟 3.1 的章節]

---

## 分散程度分析

[來自步驟 3.2 的章節]

---

## 風險評估

[來自步驟 3.3 的章節]

---

## 績效審查

[來

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

leecyno1/boutique-skills

Review fixed income portfolios by pricing multiple bonds, retrieving reference data, analyzing cashflows, and running scenario analysis. Use when reviewing bond portfolios, computing portfolio duration and DV01, analyzing cashflow waterfalls, stress testing rate scenarios, or assessing portfolio composition.

leecyno1/boutique-skills

Track and analyze portfolio company performance against plan. Ingests monthly/quarterly financial packages (Excel, PDF), extracts KPIs, flags variances to budget, and produces summary dashboards. Use when reviewing portfolio company financials, preparing board materials, or monitoring covenant compliance. Triggers on "review portfolio company", "monthly financials", "how is [company] performing", "covenant check", or "portfolio update".

leecyno1/boutique-skills

Analyze portfolio allocation drift and generate rebalancing trade recommendations across accounts. Considers tax implications, transaction costs, and wash sale rules. Triggers on "rebalance", "portfolio drift", "allocation check", "rebalancing trades", or "my portfolio is out of balance".

leecyno1/boutique-skills

Router skill for LLMQuant portfolio-lab workflows. Use when the user needs portfolio exposure maps, what-if simulations, scenario states, or virtual portfolio comparisons.

leecyno1/boutique-skills

Router skill for LLMQuant portfolio workflows. Use when the user needs company profiles, thesis tracking, theme research, watchlist monitoring, or alert management.

leecyno1/boutique-skills

Best practices for Remotion - Video creation in React

leecyno1/boutique-skills

Agent skill at skills/default/video-autopilot-kit/SKILL.md

相關技能