Communitygithub.com

tradeblocks-org/tradeblocks-skills

トレーディング戦略のポートフォリオ分析を行います。相関性、分散効果、複合パフォーマンス特性を調査します。戦略間の関係を理解したり、分散効果を探ったり、ポートフォリオ構成を分析する際に使用します。

tradeblocks-skills とは?

このスキルは、トレーディング戦略のポートフォリオ分析を実施するための包括的なツールセットです。戦略間の相関性、分散効果、限界貢献度、類似性などを多角的に分析し、ポートフォリオの健全性を評価します。主な機能として、ワンコールでポートフォリオ全体を診断する「ヘルスチェック」、戦略ペアの相関行列を表示する「相関分析」、ボラティリティレジームとトレンド方向のマトリックスを生成する「ポートフォリオ構造マップ」、各戦略のリスク調整後リターンへの影響を測定する「限界貢献度分析」、戦略プロファイルと実績を照合する「レジームアロケーションアドバイザー」、冗長な戦略を検出する「戦略類似性分析」、アロケーション変更のシミュレーションを行う「What-Ifスケーリング」などを備えています。TradeBlocks MCPサーバー上で動作し、複数の戦略ブロックまたはマルチ戦略ブロックが読み込まれていることを前提としています。分析結果はヒストリカルデータに基づく洞察として提供され、ユーザー自身のリスク許容度やポートフォリオ目標に合わせて意思決定を行うために活用されます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tradeblocks-org/tradeblocks-skills/tree/HEAD/skills/portfolio

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ポートフォリオ分析

戦略がどのように関連し、それらを組み合わせることがポートフォリオの特性にどのような意味を持つかを探ります。

このスキルの機能

ポートフォリオのダイナミクスを理解するためのデータを提供します:

  • ヘルスチェック:ワンコールでの包括的なポートフォリオ評価
  • 相関性:戦略は互いにどのように動くか?
  • 構造:ポートフォリオに重複やブラインドスポットはどこにあるか?
  • 限界貢献度:どの戦略がリスク調整後リターンを向上または低下させるか?
  • 類似性:冗長な戦略はあるか?
  • What-Ifスケーリング:アロケーションを変更するとポートフォリオにどのような影響があるか?

前提条件

  • TradeBlocks MCPサーバーが稼働していること
  • 複数の戦略ブロックまたはマルチ戦略ブロックが読み込まれていること
  • レジームカバレッジと構造分析には戦略プロファイルが推奨される

プロセス

ステップ1:ポートフォリオヘルスチェック

portfolio_health_checkから始めて、包括的なワンコール評価を実施します。

主要パラメータ:

  • blockId:ブロックフォルダ名
  • correlationThreshold:この値を超えるペアにフラグを立てる(デフォルト:0.5)
  • tailDependenceThreshold:この値を超えるテールペアにフラグを立てる(デフォルト:0.5)
  • profitProbabilityThreshold:MC利益確率の警告(デフォルト:0.95)
  • wfeThreshold:ウォークフォワード効率の警告(デフォルト:-0.15)

ツールは階層化されたレポートを返します:

  • 評決:HEALTHY / MODERATE_CONCERNS / SIGNIFICANT_CONCERNS
  • グレード:9つの次元でA~F:
次元測定内容
分散効果戦略ペア間の相関性
テールリスク共同の極端な連動リスク
頑健性ウォークフォワード効率(OOS vs IS)
一貫性モンテカルロの利益確率
レジームカバレッジVIXレジーム全体の戦略パフォーマンス
取引日カバレッジ週全体の取引日カバレッジ
集中リスク構造、原資産、DTEによるアロケーション
相関リスクプロファイルを考慮した重複(同一原資産+DTE+日)
スケーリングの整合性バックテストとライブの1契約あたりのP&L偏差
  • フラグ:詳細を含む特定の警告(高相関ペア、テール依存ペアなど)
  • 主要数値:シャープレシオ、ソルティノレシオ、最大ドローダウン、平均相関、平均テール依存、MC統計、WFE

評決を提示し、B未満のグレードがある次元にフラグを立て、特定の警告の詳細を表面化します。

ステップ2:相関分析

get_correlation_matrixを使用して、詳細なペアワイズ相関データを取得します。

主要パラメータ:

  • blockId:ブロックフォルダ名
  • method:「kendall」(頑健、順位ベース、デフォルト)、「spearman」(順位)、「pearson」(線形)
  • alignment:「shared」(両方が取引した日のみ)または「zero-pad」(欠損を0で埋める)
  • timePeriod:「daily」、「weekly」、または「monthly」集計
  • normalization:「raw」(絶対P&L)、「margin」(P&L/マージン)、「notional」(P&L/想定元本)
  • minSamples:有効な計算のための最小共有期間(デフォルト:10)
  • highlightThreshold:この値を超えるペアにフラグを立てる(デフォルト:0.7)

相関値の解釈:

相関意味
< 0.2非常に低い - 戦略は独立して動く
0.2 - 0.4低い - ほとんど独立した動き
0.4 - 0.6中程度 - ある程度の共有挙動
0.6 - 0.8高い - 重要な共有挙動
> 0.8非常に高い - 戦略は同様に動作する

トウヒの相関(Kendall's tau)がトレーディングリターンに対してピアソン相関よりも有益である理由については、references/correlation.mdを参照してください。

ステップ3:ポートフォリオ構造マップ

portfolio_structure_mapを使用して、プロファイル化されたすべての戦略にわたるVol_Regime x Trend_Directionマトリックスを表示します。

主要パラメータ:

  • blockId:オプション — 省略するとすべてのブロックを集約
  • minTrades:薄いデータの警告しきい値(デフォルト:10)

ツールは以下を返します:

  • 18セルのマトリックス(6 Vol_Regimes x 3 Trend_Directions)、戦略ごとの統計付き
  • 重複検出:同じセルでアクティブな2つ以上の戦略
  • ブラインドスポット:すべての戦略にわたって取引数がゼロのセル
  • 薄いデータの警告:しきい値未満の取引数を持つセル

これはポートフォリオ構築を理解するための主要なツールです — ポートフォリオがどこにカバレッジを持ち、どこに持たないかを示します。

ステップ4:限界貢献度

marginal_contributionを使用して、各戦略がポートフォリオのリスク調整後リターンにどのように影響するかを確認します。

主要パラメータ:

  • blockId:ブロックフォルダ名
  • targetStrategy:特定の戦略のみ計算(オプション)
  • topN:返す上位貢献者の数(デフォルト:5)

ツールは以下を返します:

  • ベースラインポートフォリオのシャープレシオとソルティノレシオ
  • 戦略ごとの限界シャープレシオとソルティノレシオの影響
  • 最も有益な戦略と最も有益でない戦略

解釈:

  • 負の限界シャープレシオ:この戦略を除去するとポートフォリオのシャープレシオが低下する — つまり、この戦略はプラスに貢献している
  • 正の限界シャープレシオ:この戦略を除去するとポートフォリオのシャープレシオが上昇する — つまり、この戦略はリスク調整後リターンを損なっている可能性がある
  • 注:限界貢献度はリスク調整後の影響を測定し、絶対P&Lではありません。収益性の高い戦略でも、ボラティリティを追加する場合はシャープレシオを損なう可能性があります。

ステップ5:レジームアロケーションアドバイザー

regime_allocation_advisorを使用して、戦略プロファイルの期待レジームと実際のパフォーマンスを照合します。

主要パラメータ:

  • blockId:オプション — 省略するとプロファイル化されたすべての戦略を集約
  • minTrades:信頼できる統計のためのレジームセルあたりの最小取引数(デフォルト:5)

ツールは戦略ごと、レジームごとに以下を返します:

  • そのレジームが期待されていたか(プロファイルから)、予期されていなかったか
  • そのレジームでの勝率、P&L、取引数
  • 分類:
    • thesis_aligned:戦略がターゲットレジームで期待通りにパフォーマンスを発揮している
    • thesis_violation:戦略が処理すべきレジームでパフォーマンスが低下している
    • hidden_edge:戦略が期待レジームとしてマークされていないレジームでも良好なパフォーマンスを発揮している

テーゼ違反(戦略が本来うまくいくべきレジームで失敗している)や隠れたエッジ(プロファイルが捉えていない機会)を表面化します。

ステップ6:戦略類似性

strategy_similarityを使用して、潜在的に冗長な戦略を検出します。

主要パラメータ:

  • blockId:ブロックフォルダ名
  • correlationThreshold:フラグを立てる最小相関(デフォルト:0.7)
  • tailDependenceThreshold:フラグを立てる最小テール依存(デフォルト:0.5)
  • minSharedDays:最小共有取引日数(デフォルト:30)
  • topN:最も類似したペアの数(デフォルト:5)

ツールは以下を返します:

  • 結合類似性スコアでランク付けされた最も類似した戦略ペア
  • 各ペアの相関、テール依存、取引日の重複
  • 分散効果なしにリスクを追加している可能性のある戦略のフラグ

2つの戦略が高い相関を持ち、かつ高いテール依存を持つ場合、それらは一緒にドローダウンする可能性が高い — つまり、それらの間の「分散効果」は見せかけです。

ステップ7:What-Ifスケーリング

what_if_scalingを使用して、アロケーション変更を調査します。

主要パラメータ:

  • blockId:ブロックフォルダ名
  • strategyWeights:戦略ごとのウェイト。例:{"5/7 17D": 0.5, "Pickle RIC": 1.5}。指定されていない戦略はデフォルト1.0。ウェイト0 = 除外。
  • strategies:マルチ戦略モード — 戦略ごとのブロックソースとスケールファクターを含む配列
  • showUncapped:maxContractsPerTradeの上限なしの結果も表示する

ツールは以下を返します:

  • ポートフォリオメトリクスの変更前/変更後の比較
  • 新しいウェイトでの戦略ごとの内訳
  • プロファイル認識:プロファイルからのmaxContractsPerTrade上限を尊重
  • ignoreMarginReqが設定されている場合のフラグ

一般的なシナリオ:

  • 「この戦略を除去したらどうなるか?」 → ウェイトを0に設定
  • 「このアロケーションを2倍にしたらどうなるか?」 → ウェイトを2.0に設定
  • 「最高のパフォーマンスの戦略を除いてすべてを半分にしたらどうなるか?」 → それに応じてウェイトを調整

ステップ8:調査結果の提示

データを統合します:

ポートフォリオの健全性:

  • 評決:[HEALTHY / MODERATE_CONCERNS / SIGNIFICANT_CONCERNS]
  • 注意が必要な次元:[B未満のグレードがある次元]
  • 主要フラグ:[特定の警告]

相関性の調査結果:

  • ペア全体の平均相関:[値]
  • 最も高い相関のペア:[ペア]:[値]
  • 最も低い相関のペア:[ペア]:[値]

構造:

  • レジームのブラインドスポット:[カバレッジがないセル]
  • 重複領域:[2つ以上の戦略があるセル]
  • 集中度:[原資産、DTE、構造タイプ別]

限界貢献度:

  • 最も有益な戦略:[戦略](限界シャープ:[値])
  • 最も有益でない戦略:[戦略](限界シャープ:[値])

際立っている点:

  • [注目すべきパターン]
  • [冗長な戦略ペアがあれば]
  • [テーゼ違反または隠れたエッジ]

これらをヒストリカルデータからの洞察として提示します。ユーザーが自分のリスク許容度とポートフォリオ目標に合わせて意思決定できます。

解釈の参考文献

関連スキル

ポートフォリオ分析の後:

  • /tradeblocks:compare - 特定の戦略ペアまたはブロックの詳細比較
  • /tradeblocks:risk - ポジションサイジングとケリー分析
  • /tradeblocks:health-check - 個別戦略の完全メトリクス

注記

  • 相関は取引ごとではなく、集約されたリターンに対して測定されます
  • 過去の相関パターンは将来の市場環境で継続するとは限りません
  • テール相関(危機時の挙動)は通常の相関よりも高いことが多い
  • 低相関は保護を保証しません — 両方の戦略が異なる理由で損失を出す可能性があります
  • サンプルサイズは重要 — 共有データポイント10個が最低限であり、より多い方が良い
  • レジームカバレッジ、構造マップ、スケーリング整合性の分析には戦略プロファイルが必要です

関連スキル