Portfolio Manager

# Portfolio Manager

## 概述

通过与 Alpaca MCP Server 集成获取实时持仓数据，分析和管理投资组合，执行涵盖资产配置、多元化、风险指标、个仓评估和再平衡建议的全面分析。生成包含可操作见解的详细投资组合报告。

此技能通过 MCP (Model Context Protocol) 利用 Alpaca 的经纪 API 访问实时投资组合数据，确保分析基于实际当前持仓，而非手动输入的数据。

## 何时使用

当用户请求以下内容时调用此技能： - "分析我的投资组合" - "查看我当前的持仓" - "我的资产配置如何？" - "检查我的投资组合风险" - "我应该再平衡我的投资组合吗？" - "评估我的持仓" - "投资组合业绩回顾" - "我该买进或卖出哪些股票？" - 任何涉及投资组合级别分析或管理的请求

## 先决条件

### Alpaca MCP Server 设置

此技能需要配置并连接 Alpaca MCP Server。MCP 服务器提供对以下内容的访问： - 当前投资组合持仓 - 账户权益和购买力 - 历史持仓和交易记录 - 持有证券的市场数据

**使用的 MCP Server 工具：** - `get_account_info` - 获取账户权益、购买力、现金余额 - `get_positions` - 检索所有当前持仓及其数量、成本基数、市值 - `get_portfolio_history` - 历史投资组合业绩数据 - 用于报价和基本面数据的市场数据工具

如果未连接 Alpaca MCP Server，请通知用户并提供 `references/alpaca_mcp_setup.md` 中的设置说明。

## 工作流程

### 步骤 1：通过 Alpaca MCP 获取投资组合数据

使用 Alpaca MCP Server 工具收集当前投资组合信息：

**1.1 获取账户信息：** ``` Use mcp__alpaca__get_account_info to fetch: - Account equity (total portfolio value) - Cash balance - Buying power - Account status ```

**1.2 获取当前持仓：** ``` Use mcp__alpaca__get_positions to fetch all holdings: - Symbol ticker - Quantity held - Average entry price (cost basis) - Current market price - Current market value - Unrealized P&L ($ and %) - Position size as % of portfolio ```

**1.3 获取投资组合历史（可选）：** ``` Use mcp__alpaca__get_portfolio_history for performance analysis: - Historical equity values - Time-weighted return calculation - Drawdown analysis ```

**数据验证：** - 验证所有持仓均有有效的股票代码 - 确认市值总和约等于账户权益 - 检查是否有陈旧或非活跃持仓 - 处理边缘情况（零碎股、期权、支持的加密货币）

### 步骤 2：丰富持仓数据

对于投资组合中的每个持仓，收集额外的市场数据和基本面信息：

**2.1 当前市场数据：** - 实时或延迟的报价 - 日成交量和流动性指标 - 52周区间 - 市值

**2.2 基本面数据：** 使用 WebSearch 或可用的市场数据 API 获取： - 行业和板块分类 - 关键估值指标（P/E, P/B, 股息率） - 近期收益和财务健康指标 - 分析师评级和目标价 - 近期新闻和重大进展

**2.3 技术分析：** - 价格趋势（20日、50日、200日移动平均线） - 相对强弱 - 支撑和阻力位 - 动量指标（RSI, MACD 如可用）

### 步骤 3：投资组合级别分析

使用参考文件中的框架执行全面的投资组合分析：

#### 3.1 资产配置分析

**阅读 references/asset-allocation.md** 了解配置框架

分析在多个维度上的当前配置：

**按资产类别：** - 股票 vs 固定收益 vs 现金 vs 另类投资 - 与用户风险状况的目标配置进行比较 - 评估配置是否符合投资目标

**按板块：** - 科技、医疗保健、金融、消费等 - 识别板块集中度风险 - 与基准板块权重进行比较（例如 S&P 500）

**按市值：** - 大盘股 vs 中盘股 vs 小盘股分布 - 超大盘股的集中度 - 市值多元化评分

**按地域：** - 美国 vs 国际 vs 新兴市场 - 国内集中度风险评估

**输出格式：** ```markdown ## Asset Allocation

### Current Allocation vs Target | Asset Class | Current | Target | Variance | |-------------|---------|--------|----------| | US Equities | XX.X% | YY.Y% | +/- Z.Z% | | ... |

### Sector Breakdown [Pie chart description or table with sector percentages]

### Top 10 Holdings | Rank | Symbol | % of Portfolio | Sector | |------|--------|----------------|--------| | 1 | AAPL | X.X% | Technology | | ... | ```

#### 3.2 多元化分析

**阅读 references/diversification-principles.md** 了解多元化理论

评估投资组合多元化质量：

**持仓集中度：** - 识别前十大持仓及其总权重 - 如果任何单个持仓超过投资组合的 10-15% 则标记 - 计算 Herfindahl-Hirschman Index (HHI) 以衡量集中度

**板块集中度：** - 识别主导板块 - 如果任何板块超过投资组合的 30-40% 则标记 - 与基准板块多样性进行比较

**相关性分析：** - 估算主要持仓之间的相关性 - 识别高度相关的持仓（潜在冗余） - 评估真正的多元化效益

**持仓数量：** - 个人投资组合的最佳范围：15-30 只股票 - 如果多元化不足（<10 只股票）或过度多元化（>50 只股票）则标记

**输出：** ```markdown ## Diversification Assessment

**Concentration Risk:** [Low / Medium / High] - Top 5 holdings represent XX% of portfolio - Largest single position: [SYMBOL] at XX%

**Sector Diversification:** [Excellent / Good / Fair / Poor] - Dominant sector: [Sector Name] at XX% - [Assessment of balance across sectors]

**Position Count:** [Optimal / Under-diversified / Over-diversified] - Total positions: XX stocks - [Recommendation]

**Correlation Concerns:** - [List any highly correlated position pairs] - [Diversification improvement suggestions] ```

#### 3.3 风险分析

**阅读 references/portfolio-risk-metrics.md** 了解风险衡量框架

计算并解释关键风险指标：

**波动性衡量：** - 估算投资组合 Beta（持仓 Beta 的加权平均值） - 个别持仓波动率 - 投资组合标准差（如有历史数据可用）

**下行风险：** - 最大回撤（来自投资组合历史） - 自高点的当前回撤 - 具有重大未实现损失的持仓

**风险集中度：** - 高波动率股票的百分比（Beta > 1.5） - 投机/无利可图公司的百分比 - 杠杆使用情况（如适用）

**尾部风险：** - 对潜在黑天鹅事件的敞口 - 单股集中度风险 - 板块特定事件风险

**输出：** ```markdown ## Risk Assessment

**Overall Risk Profile:** [Conservative / Moderate / Aggressive]

**Portfolio Beta:** X.XX (vs market at 1.00) - Interpretation: Portfolio is [more/less] volatile than market

**Maximum Drawdown:** -XX.X% (from $XXX,XXX to $XXX,XXX) - Current drawdown from peak: -XX.X%

**High-Risk Positions:** | Symbol | % of Portfolio | Beta | Risk Factor | |--------|----------------|------|-------------| | [TICKER] | XX% | X.XX | [High volatility / Recent loss / etc] |

**Risk Concentrations:** - XX% in single sector ([Sector]) - XX% in stocks with beta > 1.5 - [Other concentration risks]

**Risk Score:** XX/100 ([Low/Medium/High] risk) ```

#### 3.4 业绩分析

使用可用数据评估投资组合业绩：

**绝对收益：** - 整体投资组合未实现盈亏（金额和百分比） - 表现最好的持仓（按涨幅百分比前5名） - 表现最差的持仓（按跌幅百分比前5名）

**时间加权收益（如有历史数据）：** - 年初至今 (YTD) 收益 - 1年、3年、5年年化收益 - 与基准（S&P 500, 相关指数）进行比较

**持仓级别业绩：** - 盈利股与亏损股比率 - 盈利持仓的平均收益 - 亏损持仓的平均亏损 - 接近 52周高点/低点的持仓

**输出：** ```markdown ## Performance Review

**Total Portfolio Value:** $XXX,XXX **Total Unrealized P&L:** $XX,XXX (+XX.X%) **Cash Balance:** $XX,XXX (XX% of portfolio)

**Best Performers:** | Symbol | Gain | Position Value | |--------|------|----------------| | [TICKER] | +XX.X% | $XX,XXX | | ... |

**Worst Performers:** | Symbol | Loss | Position Value | |--------|------|----------------| | [TICKER] | -XX.X% | $XX,XXX | | ... |

**Performance vs Benchmark (if available):** - Portfolio return: +X.X% - S&P 500 return: +Y.Y% - Alpha: +/- Z.Z% ```

### 步骤 4：个仓分析

对主要持仓（按投资组合权重排名前 10-15）进行详细分析：

**阅读 references/position-evaluation.md** 了解持仓分析框架

对于每个重要持仓：

**4.1 当前投资逻辑验证：** - 最初为何建立此持仓？（如从用户上下文中已知） - 投资逻辑是否已实现或失效？ - 近期公司进展和新闻

**4.2 估值评估：** - 当前估值指标（P/E, P/B 等） - 与历史估值区间进行比较 - 与同行板块进行比较 - 高估 / 公平 / 低估评估

**4.3 技术面健康状况：** - 价格趋势（上升趋势、下降趋势、横盘） - 持仓相对于移动平均线的位置 - 支撑和阻力位 - 动量状态

**4.4 持仓规模：** - 当前在投资组合中的权重 - 鉴于信心水平和风险，规模是否适当？ - 相对于最优水平的超配还是低配

**4.5 行动建议：** - **持有 (HOLD)** - 持仓规模适当，投资逻辑完好 - **加仓 (ADD)** - 给定机会下低配，投资逻辑增强 - **减仓 (TRIM)** - 超配或估值过高 - **卖出 (SELL)** - 投资逻辑失效，别处有更好的机会

**每个持仓的输出：** ```markdown ### [SYMBOL] - [Company Name] (XX.X% of portfolio)

**Position Details:** - Shares: XXX - Avg Cost: $XX.XX - Current Price: $XX.XX - Market Value: $XX,XXX - Unrealized P/L: $X,XXX (+XX.X%)

**Fundamental Snapshot:** - Sector: [Sector] - Market Cap: $XX.XB - P/E: XX.X | Dividend Yield: X.X% - Recent developments: [Key news or earnings]

**Technical Status:** - Trend: [Uptrend / Downtrend / Sideways] - Price vs 50-day MA: [Above/Below by XX%] - Support: $XX.XX | Resistance: $XX.XX

**Position Assessment:** - **Thesis Status:** [Intact / Weakening / Broken / Strengthening] - **Valuation:** [Undervalued / Fair / Overvalued] - **Position Sizing:** [Optimal / Overweight / Underweight]

**Recommendation:** [HOLD / ADD / TRIM / SELL] **Rationale:** [1-2 sentence explanation] ```

### 步骤 5：再平衡建议

**阅读 references/rebalancing-strategies.md** 了解再平衡方法

生成具体的再平衡建议：

**5.1 识别再平衡触发器：** - 显著偏离目标权重的持仓 - 需要调整的板块/资产类别配置 - 需要减仓的超配持仓（超过阈值） - 需要加仓的低配领域（低于阈值） - 税务考虑（资本利得影响）

**5.2 制定再平衡计划：**

**需减仓 (TRIM) 的持仓：** - 超配持仓（偏离目标 > 阈值） - 大幅上涨的股票（估值担忧） - 超过投资组合 15-20% 的集中持仓 - 投资逻辑失效的持仓

**需加仓 (ADD) 的持仓：** - 低配板块或资产类别 - 目前低配的高信心持仓 - 用于改善多元化的新机会

**现金配置：** - 如果有过量现金（> 投资组合的 10%），建议配置 - 根据机会和配置缺口确定优先级

**5.3 优先级排序：** 按优先级对再平衡操作进行排名： 1. **立即** - 降低风险（减仓集中持仓） 2. **高优先级** - 主要配置偏离（偏离目标 > 10%） 3. **中优先级** - 中等偏离（偏离目标 5-10%） 4. **低优先级** - 微调和机会性调整

**输出：** ```markdown ## Rebalancing Recommendations

### Summary - **Rebalancing Needed:** [Yes / No / Optional] - **Primary Reason:** [Concentration risk / Sector drift / Cash deployment / etc] - **Estimated Trades:** X sell orders, Y buy orders

### Recommended Actions

#### HIGH PRIORITY: Risk Reduction **TRIM [SYMBOL]** from XX% to YY% of portfolio - **Shares to Sell:** XX shares (~$XX,XXX) - **Rationale:** [Overweight / Valuation extended / etc] - **Tax Impact:** $X,XXX capital gain (est)

#### MEDIUM PRIORITY: Asset Allocation **ADD [Sector/Asset Class]** exposure - **Target:** Increase from XX% to YY% - **Suggested Stocks:** [SYMBOL1, SYMBOL2, SYMBOL3] - **Amount to Invest:** ~$XX,XXX

#### CASH DEPLOYMENT **Current Cash:** $XX,XXX (XX% of portfolio) - **Recommendation:** [Deploy / Keep for opportunities / Reduce to X%] - **Suggested Allocation:** [Distribution across sectors/stocks]

### Implementation Plan 1. [First action - highest priority] 2. [Second action] 3. [Third action] ...

**Timing Considerations:** - [Tax year-end planning / Earnings season / Market conditions] - [Suggested phasing if applicable] ```

### 步骤 6：生成投资组合报告

创建保存到仓库根目录的综合 Markdown 报告：

**文件名：** `portfolio_analysis_YYYY-MM-DD.md`

**报告结构：**

```markdown # Portfolio Analysis Report

**Account:** [Account type if available] **Report Date:** YYYY-MM-DD **Portfolio Value:** $XXX,XXX **Total P&L:** $XX,XXX (+XX.X%)

---

## Executive Summary

[3-5 bullet points summarizing key findings] - Overall portfolio health assessment - Major strengths - Key risks or concerns - Primary recommendations

---

## Holdings Overview

[Summary table of all positions]

---

## Asset Allocation [Section from Step 3.1]

---

## Diversification Analysis [Section from Step 3.2]

---

## Risk Assessment [Section from Step 3.3]

---

## Performance Review [Section from Step 3.4]

---

## Position Analysis [Detailed analysis of top 10-15 positions from Step 4]

---

## Rebalancing Recommendations [Section from Step 5]

---

## Action Items

**Immediate Actions:** - [ ] [Action 1] - [ ] [Action 2]

**Medium-Term Actions:** - [ ] [Action 3] - [ ] [Action 4]

**Monitoring Priorities:** - [ ] [Watch list item 1] - [ ] [Watch list item 2]

---

## Appendix: Full Holdings

[Complete table with all positions and metrics] ```

### 步骤 7：交互式跟进

准备好回答后续问题：

**常见问题：**

**“我为什么要卖出 [代码]？”** - 解释具体担忧（估值、逻辑失效、集中度） - 提供支持数据 - 如适用，提供替代持仓

**“我应该买进什么来代替？”** - 建议具体股票以改善配置 - 解释它们如何解决投资组合缺口 - 提供简短的投资逻辑

**“我最大的风险是什么？”** - 识别主要风险因素（集中度、板块敞口、波动性） - 量化风险 - 建议缓解策略

**“我的投资组合与 [基准] 相比如何？”** - 比较配置、板块权重、风险指标 - 突出关键差异 - 评估差异是否合理

**“我应该现在再平衡还是等待？”** - 考虑市场状况、税务影响、交易成本 - 提供有理有据的时机建议

**“你能更详细地分析 [特定持仓] 吗？”** - 如需要，使用 us-stock-analysis 技能进行深入分析 - 将发现整合回投资组合上下文中

## 分析框架

### 目标配置模板

此技能包含针对不同投资者画像的参考配置模型：

**参考 references/target-allocations.md** 获取详细模型：

- **保守型**（资本保值，侧重收益） - **稳健型**（平衡增长与收益） - **成长型**（长期资本增值） - **激进型**（最大化增长，高风险承受能力）

每个模型包括： - 资产类别目标（股票/债券/现金/另类资产） - 行业指导原则 - 市值分布 - 地域配置 - 仓位规模规则

当用户未指定其配置策略时，请将这些作为比较基准。

### 风险画像评估

如果用户的目标配置未知，请根据以下因素评估适当的风险画像： - 年龄（如果提及） - 投资时间线（如果提及） - 当前配置（揭示偏好） - 持仓类型（保守型股票与投机型股票对比）

**参考 references/risk-profile-questionnaire.md** 获取评估框架

## 输出指南

**语调和风格：** - 客观且具有分析性 - 提供明确理由的可操作建议 - 承认市场预测的不确定性 - 在乐观与风险意识之间保持平衡 - 尽可能量化

**数据展示：** - 使用表格进行比较和展示指标 - 分配比例和回报率使用百分比 - 绝对值使用美元金额 - 整个报告保持一致的格式

**建议清晰度：** - 明确的动词（TRIM 减仓, ADD 加仓, HOLD 持有, SELL 卖出） - 具体数量（卖出 XX 股，加仓 $X,XXX） - 优先级（Immediate 立即, High 高, Medium 中, Low 低） - 每条建议的支持理由

**视觉描述：** - 像创建饼图一样描述配置细分 - 将行业权重描述为条形图的等价物 - 使用方向指示符（↑ ↓ →）描述表现趋势

## 参考文件

在分析期间根据需要加载这些参考文件：

**references/alpaca-mcp-setup.md** - 使用时机：用户需要帮助设置 Alpaca MCP 服务器 - 内容：安装说明、API 密钥配置、MCP 服务器连接步骤、故障排除

**references/asset-allocation.md** - 使用时机：分析投资组合配置或创建再平衡计划 - 内容：资产配置理论、按风险画像划分的最优配置、行业配置指导原则、再平衡触发条件

**references/diversification-principles.md** - 使用时机：评估投资组合多元化质量 - 内容：现代投资组合理论基础知识、相关性概念、最优持仓数量、集中度风险阈值、多元化指标

**references/portfolio-risk-metrics.md** - 使用时机：计算风险评分或解读波动率 - 内容：Beta 计算、标准差、夏普比率、最大回撤、风险价值、风险调整后回报指标

**references/position-evaluation.md** - 使用时机：分析单个持仓以做出买入/持有/卖出决策 - 内容：持仓分析框架、投资论点验证清单、仓位规模指导原则、卖出纪律标准

**references/rebalancing-strategies.md** - 使用时机：制定再平衡建议 - 内容：再平衡方法（基于日历、基于阈值、战术性）、税收优化策略、交易成本考量、实施时机

**references/target-allocations.md** - 使用时机：需要基准配置进行比较 - 内容：针对保守型/稳健型/成长型/激进型投资者的模型投资组合、行业目标范围、市值分布

**references/risk-profile-questionnaire.md** - 使用时机：用户未指定风险承受能力或目标配置 - 内容：风险评估问题、评分方法、风险画像分类

## 错误处理

**如果 Alpaca MCP 服务器未连接：** 1. 告知用户需要 Alpaca 集成 2. 提供来自 references/alpaca-mcp-setup.md 的设置说明 3. 提供替代方案：手动数据输入（不太理想，用户需提供持仓 CSV）

**如果 API 返回不完整的数据：** - 使用可用数据继续 - 在报告中注明局限性 - 建议手动验证缺失的持仓

**如果持仓数据似乎过时：** - 标记此问题 - 建议刷新连接或检查 Alpaca 状态 - 继续分析但对调查结果加以说明

**如果用户没有持仓：** - 确认投资组合为空 - 提供投资组合构建指导而非分析 - 建议使用 value-dividend-screener 或 us-stock-analysis 获取股票思路

## 高级功能

### 税收亏损收割机会

识别适合税收亏损收割的未实现亏损持仓： - 亏损 > 5% 的持仓 - 持有期考量（避免洗售规则） - 替代证券建议（相似但非“实质上相同”）

### 股息收入分析

对于包含支付股息的股票的投资组合： - 预估年度股息收入 - 股息增长率轨迹 - 股息覆盖率和可持续性 - 长期持有的股息成本收益率

### 相关性矩阵

对于包含 5-20 个持仓的投资组合： - 估算主要持仓之间的相关性 - 识别冗余持仓（相关性 > 0.8） - 建议多元化改进措施

### 情景分析

模拟不同情景下的投资组合行为： - **牛市**（股票上涨 +20%） - **熊市**（股票下跌 -20%） - **板块轮动**（科技股疲软，价值股强劲） - **加息**（对成长股和债券的影响）

## 示例查询

**基础投资组合回顾：** - “Analyze my portfolio”（分析我的投资组合） - “Review my positions”（回顾我的持仓） - “How's my portfolio doing?”（我的投资组合表现如何？）

**配置分析：** - “What's my asset allocation?”（我的资产配置是怎样的？） - “Am I too concentrated in tech?”（我在科技股上是否过于集中？） - “Show me my sector breakdown”（展示我的行业细分）

**风险评估：** - “Is my portfolio too risky?”（我的投资组合是否风险过高？） - “What's my portfolio beta?”（我的投资组合 Beta 是多少？） - “What are my biggest risks?”（我最大的风险是什么？）

**再平衡：** - “Should I rebalance?”（我应该再平衡吗？） - “What should I buy or sell?”（我应该买什么或卖什么？） - “How can I improve diversification?”（我如何改善多元化？）

**业绩表现：** - “What are my best and worst positions?”（我表现最好和最差的持仓是什么？） - “How am I performing vs the market?”（我与市场相比表现如何？） - “Which stocks are winning and losing?”（哪些股票在盈利和亏损？）

**特定持仓：** - “Should I sell [SYMBOL]?”（我应该卖出 [代码] 吗？） - “Is [SYMBOL] overweight in my portfolio?”（[代码] 在我的投资组合中是否超配？） - “What should I do with [SYMBOL]?”（我该如何处理 [代码]？）

## 局限性与免责声明

**包含在所有报告中：**

*本分析仅供参考，不构成财务建议。投资决策应基于个人情况、风险承受能力和财务目标做出。过往业绩不保证未来结果。在做出投资决定前，请咨询合格的专业财务顾问。*

*数据准确性取决于 Alpaca API 和第三方市场数据来源。请独立验证关键信息。税收影响仅为估算；如需具体指导，请咨询税务专业人士。*