portfolio-manager

ポートフォリオマネージャー

概要

Alpaca MCP Server と連携してリアルタイムの保有データを取得し、資産配分、分散、リスク指標、個別ポジションの評価、リバランスの推奨事項などを包括的に分析して、投資ポートフォリオを管理します。実行可能な知見を含む詳細なポートフォリオレポートを作成します。

証券口座の包括的な分析では、MCP 経由で Alpaca の API を使用して、リアルタイムのポートフォリオデータを取得します。これとは別に、CSV による限定的な資産配分レビューをオフラインで利用できます。これは証券口座の包括的な分析やワークフローには対応していません。

使用するタイミング

ユーザーから次のような依頼があった場合に、このスキルを呼び出します。

• 「ポートフォリオを分析して」
• 「現在のポジションを確認して」
• 「資産配分はどうなっている？」
• 「ポートフォリオのリスクを確認して」
• 「ポートフォリオをリバランスすべき？」
• 「保有資産を評価して」
• 「ポートフォリオのパフォーマンスをレビューして」
• 「どの株を買うか、または売るべき？」
• ポートフォリオ全体の分析や管理に関する依頼

前提条件

限定的なオフライン CSV レビュー

認証情報を使わずに、ローカルの米ドル建て株式保有スナップショットを確認するには、 references/csv-holdings-review.md を読み、明示的な ソースのタイムスタンプを指定して scripts/review_csv.py を実行します。オフラインでの実行を検証するには、同梱の架空の CSV を使用してください。 この処理で出力されるのは、グロス配分とポジションごとの未実現損益のみです。口座エクスポージャー、レバレッジ、過去のパフォーマンスは 測定できません。個人の保有情報やレポートはローカルに保管してください。この限定モードでは、 証券口座のデータを取得したり、包括的なワークフローを続行したりしないでください。Navigator／ワークフローとの統合はまだリリースされていません。

Alpaca MCP Server のセットアップ（証券口座の包括的な分析）

証券口座の包括的な分析には、Alpaca MCP Server の設定と接続が必要です。MCP サーバーから、次の情報にアクセスできます。

• 現在のポートフォリオのポジション
• 口座の純資産と購買力
• 過去のポジションと取引
• 保有証券の市場データ

使用する MCP サーバーツール：

• get_account_info - 口座の純資産、購買力、現金残高を取得
• get_positions - 数量、取得原価、時価を含むすべての現在のポジションを取得
• get_portfolio_history - 過去のポートフォリオパフォーマンスデータ
• 価格の気配値やファンダメンタルズを取得する市場データツール

Alpaca MCP Server が接続されていない場合は、その旨をユーザーに伝え、references/alpaca-mcp-setup.md のセットアップ手順を案内してください。

REST フォールバック接続チェック

リポジトリのルートから接続チェックを実行します。まずペーパー取引の認証情報を使用してください。 認証情報をレポートに貼り付けたり、リポジトリにコミットしたりしないでください。

export ALPACA_API_KEY="<alpaca-key-id>"
export ALPACA_SECRET_KEY="<alpaca-secret-key>"
export ALPACA_PAPER="true"
uv run python skills/portfolio-manager/scripts/check_alpaca_connection.py

このコマンドは、機密情報を除いた診断サマリーを標準出力に書き込み、口座エンドポイントとポジションエンドポイントの両方が成功した場合にのみゼロを返します。レポートファイルの作成や注文の発注は行いません。

ワークフロー

ステップ 1：Alpaca MCP または REST フォールバックでポートフォリオデータを取得する

利用可能な場合は、Alpaca MCP Server ツールを使って現在のポートフォリオ情報を収集します。スケジュールされた Hermes ジョブでは、Alpaca の認証情報が設定されていても MCP ツールが利用できない場合があります。その場合は、ALPACA_API_KEY、ALPACA_SECRET_KEY、ALPACA_PAPER を使って Alpaca REST API を直接呼び出します。

1.1 アカウント情報を取得する：

Preferred: use mcp__alpaca__get_account_info to fetch:
- Account equity (total portfolio value)
- Cash balance
- Buying power
- Account status

Fallback REST endpoints:
- paper: https://paper-api.alpaca.markets/v2/account
- live:  https://api.alpaca.markets/v2/account
Headers:
- APCA-API-KEY-ID=$ALPACA_API_KEY
- APCA-API-SECRET-KEY=$ALPACA_SECRET_KEY

1.2 現在のポジションを取得する：

Preferred: 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

Fallback REST endpoints:
- paper: https://paper-api.alpaca.markets/v2/positions
- live:  https://api.alpaca.markets/v2/positions

1.3 ポートフォリオ履歴を取得する（任意）：

Preferred: use mcp__alpaca__get_portfolio_history for performance analysis:
- Historical equity values
- Time-weighted return calculation
- Drawdown analysis

Fallback REST endpoint:
- /v2/account/portfolio/history

スケジュール済みジョブでのフォールバック時の注意事項：

• ソースを MCP ではなく Alpaca REST fallback と明記します。
• ALPACA_PAPER=true の場合はペーパー用エンドポイントを選択し、それ以外の場合はライブ用エンドポイントを使います。
• 引き続き、ロングの時価評価額と現金の合計が純資産とおおむね一致することを検証し、long_market_value > equity の場合は証拠金やレバレッジを明示します。
• 週次のコアポートフォリオの cron ジョブでは、純資産を分母としたエクスポージャーも時価総額を分母とした場合とあわせて計算します。具体的には、gross_long_exposure = long_market_value / equity、cash_pct = cash / equity を計算し、グロス・エクスポージャーが 100％を大きく上回る場合、または現金がマイナスの場合は、証拠金で資金調達されたポートフォリオであることを明示します。口座にレバレッジがかかっている場合に、グロス・ロングを分母にするだけでセクター比率が問題ないように見せてはいけません。
• 依頼で配当保有銘柄や強制レビューのトリガーが重視されている場合は、現在の保有銘柄から正規化したモニター入力を作成し、説明文だけのセクションとして配当レビューを扱うのではなく、kanchi-dividend-review-monitor に渡します。また、口座の所在地に関する注記が求められている場合は、kanchi-dividend-us-tax-accounting 用の税務計画入力も作成します。口座種別や保有期間の条件が確認できない場合は、データが不完全であることを明記します。

データ検証：

• すべてのポジションのティッカーシンボルが有効であることを確認します。
• 時価評価額の合計が口座の純資産とおおむね一致することを確認します。
• 古くなっているポジションや取引が停止したポジションがないか確認します。
• 端株、オプション、暗号資産（サポートされている場合）などの特殊なケースに対応します。

週次の配分レビュー前に保有銘柄を照合する

core-portfolio-weekly では、 references/position-reconciliation.md に従って、scripts/reconcile_positions.py を使用し、ブローカーの全件スナップショットと ACTIVE / PARTIALLY_CLOSED のメモリスナップショットを比較します。JSON と Markdown の照合レポートを生成します。can_continue が false の場合、またはスナップショットの完全性、口座との対応関係、鮮度を確認できない場合は、配分とリバランスのレビューを中止します。不一致は手動で解決できるように残し、照合を通じて注文を出したり、投資仮説を変更したりしてはいけません。これはオフラインで手動準備するゲートであり、既存の週次リプレイ用フィクスチャではまだ実行されません。

ステップ 2：ポジションデータを拡充する

ポートフォリオ内の各ポジションについて、市場データとファンダメンタルズを追加で収集します。

2.1 現在の市場データ：

• リアルタイムまたは遅延の価格気配
• 1 日の出来高と流動性指標
• 52 週の値幅
• 時価総額

2.2 ファンダメンタルズデータ： WebSearch または利用可能な市場データ API を使って、以下を取得します。

• セクターと業種の分類
• 主なバリュエーション指標（P/E、P/B、配当利回り）
• 直近の決算と財務健全性の指標
• アナリスト評価と目標株価
• 最近のニュースと重要な動向

2.3 テクニカル分析：

• 株価のトレンド（20 日、50 日、200 日移動平均）
• 相対的な強さ
• サポートラインとレジスタンスライン
• モメンタム指標（利用可能な場合は RSI、MACD）

ステップ 3：ポートフォリオ全体の分析

参考ファイルのフレームワークを使って、包括的なポートフォリオ分析を実施します。

3.1 資産配分の分析

references/asset-allocation.md を読み、資産配分のフレームワークを確認します。

現在の資産配分を複数の観点から分析します。

資産クラス別：

• 株式と債券、現金、オルタナティブの比較
• ユーザーのリスクプロファイルに応じた目標配分との比較
• 配分が投資目標に合致しているかの評価

セクター別：

• テクノロジー、ヘルスケア、金融、一般消費財など
• セクター集中リスクの特定
• ベンチマークのセクター配分（例：S&P 500）との比較

時価総額別：

• 大型株、中型株、小型株の配分
• 超大型株への集中度
• 時価総額分散スコア

地域別：

• 米国、海外、新興市場の配分
• 国内集中リスクの評価

出力形式（値は例示）：

## Asset Allocation

### Current Allocation vs Target
| Asset Class | Current | Target | Variance |
|-------------|---------|--------|----------|
| US Equities | 70.0% | 60.0% | +10.0 pp |

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

### Top 10 Holdings
| Rank | Symbol | % of Portfolio | Sector |
|------|--------|----------------|--------|
| 1 | AAPL | 8.5% | Technology |

3.2 分散分析

references/diversification-principles.md を読み、分散投資の理論を確認します。

ポートフォリオの分散の質を評価します。

保有銘柄の集中度：

• 上位保有銘柄とその合計比率を特定
• いずれか1銘柄がポートフォリオの10～15％を超える場合に警告
• 集中度の測定にハーフィンダール・ハーシュマン指数（HHI）を算出

セクター集中度：

• 比率の高いセクターを特定
• いずれかのセクターがポートフォリオの30～40％を超える場合に警告
• ベンチマークのセクター分散度と比較

相関分析：

• 主な保有銘柄間の相関を推定
• 相関の高い保有銘柄（潜在的な重複）を特定
• 実質的な分散効果を評価

保有銘柄数：

• 最適な範囲：個人のポートフォリオでは株式15～30銘柄
• 分散不足（10銘柄未満）または過剰分散（50銘柄超）の場合に警告

出力（値は例示）：

## Diversification Assessment

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

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

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

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

3.3 リスク分析

references/portfolio-risk-metrics.md を読み、リスク測定のフレームワークを確認します。

主要なリスク指標を算出し、解釈します。

ボラティリティ指標：

• ポートフォリオのベータ推定値（保有銘柄のベータの加重平均）
• 個々の保有銘柄のボラティリティ
• ポートフォリオの標準偏差（過去のデータがある場合）

下方リスク：

• 最大ドローダウン（ポートフォリオの履歴に基づく）
• 最高値からの現在のドローダウン
• 含み損が大きい保有銘柄

リスク集中度：

• 高ボラティリティ株式（ベータ > 1.5）の割合
• 投機的企業または赤字企業の割合
• レバレッジの利用状況（該当する場合）

テールリスク：

• ブラックスワンとなり得る事象へのエクスポージャー
• 個別銘柄の集中リスク
• セクター固有のイベントリスク

出力（値は例示）：

## Risk Assessment

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

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

**Maximum Drawdown:** -14.2% (from $125,000 to $107,250)
- Current drawdown from peak: -6.3%

**High-Risk Positions:**
| Symbol | % of Portfolio | Beta | Risk Factor |
|--------|----------------|------|-------------|
| NVDA | 11% | 1.65 | High volatility |

**Risk Concentrations:**
- 31% in a single sector (Technology)
- 18% in stocks with beta above 1.5
- [Other concentration risks]

**Risk Score:** 68/100 (Medium risk)

3.4 パフォーマンス分析

利用可能なデータを用いて、ポートフォリオのパフォーマンスを評価します。

絶対リターン：

• ポートフォリオ全体の含み損益（金額および％）
• パフォーマンス上位の保有銘柄（上昇率上位5銘柄）
• パフォーマンス下位の保有銘柄（下落率下位5銘柄）

時間加重リターン（履歴データがある場合）：

• 年初来リターン
• 1年、3年、5年の年率換算リターン
• ベンチマーク（S&P 500、関連する指数）との比較

保有銘柄別のパフォーマンス：

• 値上がり銘柄と値下がり銘柄の比率
• 値上がり銘柄の平均上昇率
• 値下がり銘柄の平均下落率
• 52週高値または安値に近い保有銘柄

出力（値は例示）：

## Performance Review

**Total Portfolio Value:** $100,000
**Total Unrealized P&L:** $8,500 (+9.3%)
**Cash Balance:** $5,000 (5% of portfolio)

**Best Performers:**
| Symbol | Gain | Position Value |
|--------|------|----------------|
| AAPL | +22.4% | $12,240 |

**Worst Performers:**
| Symbol | Loss | Position Value |
|--------|------|----------------|
| INTC | -12.0% | $6,600 |

**Performance vs Benchmark (illustrative values):**
- Portfolio return: +9.3%
- S&P 500 return: +7.8%
- Alpha: +1.5 percentage points

ステップ 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 - 投資仮説が崩れており、他により良い機会があります

ポジションごとの出力（値は例示）：

### AAPL - Apple Inc. (8.5% of portfolio)

**Position Details:**
- Shares: 50
- Avg Cost: $150.00
- Current Price: $170.00
- Market Value: $8,500
- Unrealized P/L: $1,000 (+13.3%)

**Fundamental Snapshot:**
- Sector: [Sector]
- Market Cap: $3.2T
- P/E: 31.4 | Dividend Yield: 0.5%
- Recent developments: [Key news or earnings]

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

**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 リバランス計画を策定する：

削減するポジション：

• オーバーウェイトのポジション（目標からの乖離がしきい値を超過）
• 大幅に上昇した銘柄（バリュエーション上の懸念）
• ポートフォリオの 15～20％を超える集中ポジション
• 投資仮説が崩れたポジション

追加するポジション：

• アンダーウェイトのセクターまたは資産クラス
• 確信度が高く、現在アンダーウェイトのポジション
• 分散を改善する新たな投資機会

現金の投入：

• 余剰現金がある場合（ポートフォリオの 10％超）、投入を提案します
• 投資機会と配分の乖離に基づいて優先順位を付けます

5.3 優先順位付け： リバランスのアクションを優先順位順に並べます。

1. 即時 - リスク低減（集中ポジションを削減）
2. 優先度高 - 大幅な配分の乖離（目標から 10％超）
3. 優先度中 - 中程度の乖離（目標から 5～10％）
4. 優先度低 - 微調整および機会に応じた調整

出力（値は例示）：

## Rebalancing Recommendations

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

### Recommended Actions

#### HIGH PRIORITY: Risk Reduction
**TRIM NVDA** from 18% to 12% of portfolio
- **Shares to Sell:** 25 shares (about $3,000)
- **Rationale:** [Overweight / Valuation extended / etc]
- **Tax Impact:** $600 capital gain (estimate)

#### MEDIUM PRIORITY: Asset Allocation
**ADD investment-grade bond exposure**
- **Target:** Increase from 10% to 20%
- **Suggested Securities:** [Select liquid securities that fit the user's mandate]
- **Amount to Invest:** About $10,000

#### CASH DEPLOYMENT
**Current Cash:** $5,000 (5% of portfolio)
- **Recommendation:** [Deploy / Keep for opportunities / Reduce to target]
- **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

レポートの構成：

# Portfolio Analysis Report

**Account:** [Account type if available]
**Report Date:** 2026-07-25
**Portfolio Value:** $100,000
**Total P&L:** $8,500 (+9.3%)

---

## 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：対話形式のフォローアップ

フォローアップの質問に回答できるよう準備します。

よくある質問：

「[SYMBOL] を売るべきなのはなぜですか？」

• 具体的な懸念（バリュエーション、投資仮説の崩れ、集中度）を説明します
• 根拠となるデータを提示します
• 該当する場合は、代替となるポジションを提案します

「代わりに何を買うべきですか？」

• 配分を改善する具体的な銘柄を提案します
• それらがポートフォリオの不足をどのように補うか説明します
• 簡潔な投資仮説を示します

「最大のリスクは何ですか？」

• 主なリスク要因（集中度、セクターエクスポージャー、ボラティリティ）を特定します
• リスクを定量化します
• リスク軽減策を提案します

「私のポートフォリオは [benchmark] と比べてどうですか？」

• 配分、セクター別ウェイト、リスク指標を比較します
• 主な違いを強調します
• その違いが妥当かを評価します

「今リバランスすべきですか、それとも待つべきですか？」

• 市場環境、税務上の影響、取引コストを考慮します
• 根拠を添えて、実施時期を推奨します

「[specific position] をさらに詳しく分析できますか？」

• 必要に応じて、us-stock-analysis スキルを使用して詳細分析を行います
• 分析結果をポートフォリオ全体の文脈に反映します

分析フレームワーク

目標配分テンプレート

このスキルには、投資家のさまざまなプロファイルに対応する参考配分モデルが含まれています。

詳細なモデルについては、references/target-allocations.md をお読みください。

• 保守型（資本の保全、インカム重視）
• 中庸型（成長とインカムのバランス）
• 成長型（長期的な資本の増加）
• 積極型（最大限の成長、高いリスク許容度）

各モデルには、以下が含まれています。

• 資産クラスの目標配分（株式／債券／現金／オルタナティブ）
• セクターの指針
• 時価総額の配分
• 地域別の配分
• ポジションサイズのルール

ユーザーが配分戦略を指定していない場合は、比較基準としてこれらを使用してください。

リスクプロファイルの評価

ユーザーの目標配分が不明な場合は、以下に基づいて適切なリスクプロファイルを評価してください。

• 年齢（言及されている場合）
• 投資期間（言及されている場合）
• 現在の配分（投資の好みが分かります）
• ポジションの種類（保守的な銘柄か、投機的な銘柄か）

評価の枠組みについては、references/risk-profile-questionnaire.md をお読みください。

出力ガイドライン

トーンとスタイル：

• 客観的かつ分析的にします。
• 明確な根拠を添え、実行に移せる提案を示します。
• 市場予測には不確実性があることを認めます。
• 楽観的な見通しとリスクへの認識のバランスを取ります。
• 可能な限り数値で示します。

データの提示：

• 比較や指標には表を使用します。
• 配分やリターンはパーセンテージで示します。
• 絶対額は金額で示します。
• レポート全体で書式を統一します。

提案の明確さ：

• 明示的な行動動詞（TRIM、ADD、HOLD、SELL）を使用します。
• 現在のポジションサイズと株価から算出した具体的な数量を示します。
• 優先度（緊急、高、中、低）を示します。
• 各提案を裏付ける根拠を示します。

視覚的な説明：

• 配分の内訳は、円グラフを作成するかのように説明します。
• セクターの比率は、棒グラフに相当する形で示します。
• パフォーマンスの傾向は、方向を示す記号（↑ ↓ →）を使って示します。

リソース

分析中、必要に応じて以下の参考資料を読み込んでください。

references/alpaca-mcp-setup.md

• 使用する場合：ユーザーが Alpaca MCP Server のセットアップを必要としているとき
• 内容：インストール手順、API キーの設定、MCP サーバーへの接続手順、トラブルシューティング

references/asset-allocation.md

• 使用する場合：ポートフォリオの配分を分析するとき、またはリバランス計画を作成するとき
• 内容：資産配分の理論、リスクプロファイル別の最適配分、セクター配分の指針、リバランスのトリガー

references/diversification-principles.md

• 使用する場合：ポートフォリオの分散の質を評価するとき
• 内容：現代ポートフォリオ理論の基礎、相関の概念、最適なポジション数、集中リスクのしきい値、分散指標

references/portfolio-risk-metrics.md

• 使用する場合：リスクスコアを計算するとき、またはボラティリティを解釈するとき
• 内容：ベータの計算、標準偏差、シャープレシオ、最大ドローダウン、バリュー・アット・リスク（VaR）、リスク調整後リターンの指標

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% を超えるポジション
• 保有期間の考慮 (ウォッシュセールルールの回避)
• 代替銘柄の提案 (類似しているが実質的に同一ではないもの)

配当収入の分析

配当を支払う銘柄を含むポートフォリオの場合:

• 年間配当収入の推定
• 配当成長率の推移
• 配当のカバレッジと持続可能性
• 長期保有における取得原価利回り (Yield on Cost)

相関行列

5～20 のポジションを持つポートフォリオの場合:

• 主要なポジション間の相関を推定します
• 冗長なポジションを特定します (相関 >0.8)
• 分散の改善を提案します

シナリオ分析

さまざまなシナリオにおけるポートフォリオの挙動をモデル化します:

• 強気相場 (+20% の株式価値上昇)
• 弱気相場 (-20% の株式価値下落)
• セクターローテーション (テクノロジー弱含み、バリュー強含み)
• 金利上昇 (成長株と債券への影響)

クエリの例

基本的なポートフォリオレビュー:

• 「私のポートフォリオを分析してください」
• 「私のポジションをレビューしてください」
• 「私のポートフォリオの調子はどうですか?」

アロケーション分析:

• 「私の資産配分はどうなっていますか?」
• 「私はテクノロジーに集中しすぎていますか?」
• 「セクター別の内訳を見せてください」

リスク評価:

• 「私のポートフォリオはリスクが高すぎますか?」
• 「私のポートフォリオのベータはいくつですか?」
• 「私の最大のリスクは何ですか?」

リバランス:

• 「リバランスすべきですか?」
• 「何を買って何を売るべきですか?」
• 「分散を改善するにはどうすればよいですか?」

パフォーマンス:

• 「私のベストとワーストのポジションは何ですか?」
• 「市場と比べて私のパフォーマンスはどうですか?」
• 「どの銘柄が勝っていて、どれが負けていますか?」

特定のポジションについて:

• 「[SYMBOL] を売却すべきですか?」
• 「[SYMBOL] は私のポートフォリオでオーバーウェイトですか?」
• 「[SYMBOL] をどう扱うべきですか?」

制約事項と免責事項

すべてのレポートに記載してください:

この分析は情報提供のみを目的としており、金融アドバイスを構成するものではありません。投資判断は、個人の状況、リスク許容度、および財務目標に基づいて行うべきです。過去のパフォーマンスは将来の結果を保証するものではありません。投資判断を行う前に、資格のあるファイナンシャルアドバイザーにご相談ください。

データの正確性は Alpaca API および第三者による市場データソースに依存します。重要な情報は独自に確認してください。税務上の影響はあくまで推定です。具体的なガイダンスについては税務の専門家にご相談ください。