Communitygithub.com

投资组合经理

通过集成 Alpaca MCP 服务器获取持仓数据,对资产配置、风险指标、个股头寸和分散化程度进行全面分析,并生成再平衡建议。

投资组合经理 是什么?

该技能是一个全面的投资组合分析与管理系统,专为使用 Alpaca 券商 API(通过 MCP 协议)获取实时持仓数据的用户设计。它能够自动提取账户信息、当前头寸和历史表现数据,然后执行多维度分析,包括资产配置(按资产类别、行业、市值和地域)、分散化质量(使用集中度指数和相关性分析)、风险评估(计算 Beta、最大回撤和下行风险)以及绩效评估(比较回报率与基准)。该技能还提供详细的个股评估(包括投资主题验证、估值和技术分析),并生成优先级排序的再平衡建议,针对仓位偏离、行业偏离和现金过剩等问题提出交易计划和税务考虑。最终输出一份结构化的 Markdown 报告(`portfolio_analysis_YYYY-MM-DD.md`),包含执行摘要、所有持仓概览、深入分析发现和可操作的建议,适用于 Cursor、Claude Code 等 AI 代理平台。

兼容平台~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 服务器集成获取实时持仓数据,对投资组合进行全面分析和管理,包括资产配置、分散化程度、风险指标、个股头寸评估和再平衡建议。生成详细的投资组合报告,并附带可执行的见解。

此技能通过 MCP(模型上下文协议)利用 Alpaca 的券商 API 访问实时投资组合数据,确保分析基于实际当前头寸,而非手动输入的数据。

使用时机

当用户提出以下请求时调用此技能:

  • "分析我的投资组合"
  • "查看我当前的头寸"
  • "我的资产配置是什么?"
  • "检查投资组合风险"
  • "我应该重新平衡投资组合吗?"
  • "评估我的持仓"
  • "投资组合绩效回顾"
  • "我应该买或卖哪些股票?"
  • 任何涉及投资组合层面分析或管理的请求

前提条件

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 另类投资
  • 与用户风险偏好的目标配置进行比较
  • 评估配置是否符合投资目标

按行业:

  • 科技、医疗、金融、消费等
  • 识别行业集中度风险
  • 与基准行业权重(例如标普 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%
- 最大单一头寸:[STOCK] 占 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%([行业])
- Beta 大于 1.5 的股票占比 XX%
- [其他集中度风险]

**风险评分:** XX/100([低/中/高]风险)

3.4 绩效分析

使用可用数据评估投资组合绩效:

绝对回报:

  • 整体投资组合未实现盈亏(美元和百分比)
  • 表现最佳的头寸(前 5 名,按涨幅百分比)
  • 表现最差的头寸(后 5 名,按跌幅百分比)

时间加权回报(如有历史记录):

  • 年初至今回报
  • 1 年、3 年、5 年年化回报
  • 与基准(标普 500、相关指数)比较

头寸层面绩效:

  • 赢家与输家比率
  • 赢家仓位的平均收益
  • 输家仓位的平均亏损
  • 接近 52 周高/低点的头寸

输出:

## 绩效回顾

**总投资组合价值:** $XXX,XXX
**总未实现盈亏:** $XX,XXX (+XX.X%)
**现金余额:** $XX,XXX(占投资组合的 XX%)

**表现最佳:**
| 代码 | 收益 | 头寸价值 |
|--------|------|----------------|
| [TICKER] | +XX.X% | $XX,XXX |
| ... |

**表现最差:**
| 代码 | 亏损 | 头寸价值 |
|--------|------|----------------|
| [TICKER] | -XX.X% | $XX,XXX |
| ... |

**与基准比较(如可用):**
- 投资组合回报:+X.X%
- 标普 500 回报:+Y.Y%
- Alpha:+/- Z.Z%

步骤 4:个股头寸分析

对于关键头寸(按投资组合权重排名前 10-15),进行详细分析:

阅读 references/position-evaluation.md 了解头寸分析框架

对于每个重要头寸:

4.1 当前投资主题验证:

  • 为何建立此头寸?(如果从用户上下文中得知)
  • 投资主题是否已兑现或失效?
  • 近期公司发展和新闻

4.2 估值评估:

  • 当前估值指标(市盈率、市净率等)
  • 与历史估值区间比较
  • 与行业同行比较
  • 高估 / 合理 / 低估评估

4.3 技术健康状况:

  • 价格趋势(上升趋势、下降趋势、横盘)
  • 相对于移动平均线的位置
  • 支撑位和阻力位
  • 动量状态

4.4 头寸规模:

  • 在投资组合中的当前权重
  • 规模是否与判断力和风险相匹配?
  • 相较于最优配置是超配还是低配

4.5 行动建议:

  • 持有 - 头寸规模合适且投资主题完好
  • 加仓 - 鉴于机会低配,投资主题增强
  • 减仓 - 超配或估值过高
  • 卖出 - 投资主题失效,有更好的机会

每个头寸的输出:

### [SYMBOL] - [公司名称](占投资组合的 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 笔买入单

### 建议行动

#### 高优先级:风险降低
**减仓 [STOCK]** 从占投资组合的 XX% 降至 YY%
- **卖出股数:** XX 股(约 $XX,XXX)
- **理由:** [超配 / 估值过高 / 等]
- **税务影响:** 预估资本利得 $X,XXX

#### 中优先级:资产配置
**增加 [行业/资产类别]** 敞口
- **目标:** 从 XX% 增至 YY%
- **建议股票:** [STOCK1, STOCK2, STOCK3]
- **投资金额:** 约 $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 的部分]

---

## 绩效回顾

[来自步骤 3.4 的部分]

---

## 个股头寸分析
[来自步骤 4 的详细分析]

---

## 再平衡建议
[来自步骤 5 的建议]

---

## 附录

**数据来源:** Alpaca API(通过 MCP)、公共市场数据
**免责声明:** 此分析仅供参考和教育之用,不构成财务建议。所有投资决策需自行研究并咨询持牌顾问。

*报告由 Portfolio Manager 技能自动生成*

步骤 7:呈现结果

向用户提供基于文本的全面分析。提供关键要点的摘要和详细分析结构。

呈现格式:

## 投资组合分析结果

### 快速摘要
- **投资组合价值:** $XXX,XXX
- **整体盈亏:** +XX.X%($XX,XXX)
- **现金配置:** XX.X%
- **总头寸数量:** XX
- **健康状况评分:** XX/100

### 关键发现
- 🟢 **优势:** [分散化良好 / 低费用 / 强劲回报]
- 🟡 **关注点:** [行业集中度 / 某些头寸高波动率]
- 🔴 **行动项:** [建议再平衡或特定调整]

### 报告已保存
一份详细的投资组合分析报告已保存至:**portfolio_analysis_YYYY-MM-DD.md**

**是否希望我深入了解某个特定方面或实施某些建议?**

参考文件

此技能使用以下参考文件提供分析框架和深入信息:

  • references/asset-allocation.md - 资产配置策略和基准
  • references/diversification-principles.md - 分散化理论和最佳实践
  • references/portfolio-risk-metrics.md - 风险衡量框架
  • references/position-evaluation.md - 个股分析标准
  • references/rebalancing-strategies.md - 再平衡方法论
  • references/alpaca_mcp_setup.md - Alpaca MCP 服务器配置

边界情况和处理

空投资组合

如果用户有一个空的投资组合(无头寸),提供:

  • 账户信息摘要(现金余额、购买力)
  • 建立投资组合的建议,根据用户的投资目标和风险承受能力

少量头寸(少于 3 个)

对于高度集中的投资组合:

  • 强调分散化不足的风险
  • 提供分散化建议(相关资产、ETF 建议)
  • 仍根据可用数据进行个股分析

数据可用性问题

如果某些数据点不可用:

  • 明确注明数据限制
  • 基于可用信息进行分析
  • 建议数据差距如何影响结论

新账户 / 历史有限

  • 注明历史数据有限制
  • 使用基础分散化和配置分析
  • 不提供基于历史波动率的详细风险指标

期权 / 复杂头寸

虽然 Alpaca 支持期权,但此技能主要关注股票头寸:

  • 如果发现期权头寸,提供警告
  • 提供头寸价值的概述
  • 建议使用专门的期权分析工具进行详细评估

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

相关技能