Communitygithub.com

george351419-sys/Portfolio-Watch-Skill

Alva 向けの再利用可能なポートフォリオ監視スキル。ポートフォリオをライブダッシュボードと静かな優先順位付き警告に変えます。市場だけでなく、購入の根拠(thesis)も監視します。Alva 上に構築され、5年間のデータでバックテストされ、ライブで動作します。

Portfolio-Watch-Skill とは?

Portfolio Watch スキルは、Alva AI エージェント向けの再利用可能な監視手法を提供します。ユーザーが「NVDA、TSLA、AAPL を監視して、大きな動きがあったら通知して」と一行でリクエストすると、ホスト型の「Portfolio Watch Playbook」を自動生成します。この Playbook は、保有銘柄の状況を確認できるインターフェースと、スマートフォンに届き該当カードにディープリンクする、静かな優先順位付きのプッシュ通知で構成されます。このスキルの核となるのは「すべてのしきい値は相対的である」という原則です。ハードコードされたパーセンテージしきい値は一切使用せず、各保有銘柄の統計的ベースラインと、その日の市場・セクターの動きに基づいて異常を検出します。これにより、未知のポートフォリオでも即座に動作する再利用性を実現しています。ビルド順序は、インテーク、プロファイルフィード(再利用性エンジン)、ウォッチフィード、Playbook インターフェース(4つのタブ)、アラートサイドカー、リリースと検証の6ステップで構成されます。Alva の Data Skills、@alva/feed、FeedAltra、@alva/pi などのプリミティブを活用し、価格・出来高・流動性の異常から、決算・提出書類・インサイダー取引などのイベント、さらには予測市場や半導体サイクル指標に至るまで、多層的な監視モデルを提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add george351419-sys/Portfolio-Watch-Skill

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

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

ドキュメント

Portfolio Watch

「私の NVDA、TSLA、AAPL を監視して、何か大きなことが起きたら知らせて」のような一行のリクエストを、ホスト型の Portfolio Watch Playbook に変換します。これは、ユーザーが保有銘柄の状況を確認できるインターフェースと、スマートフォンに届き、該当カードにディープリンクする静かな優先順位付きプッシュ通知を提供します。

このスキルは 方法論の設計図 です。Alva の構築メカニズムを置き換えるのではなく、それを駆動します。Alva はプリミティブ(Data Skills、ランタイムフィード、Altra、alpi、Playbook リリース、プッシュ)を所有し、このスキルは 監視の判断(次元、しきい値、ノイズフィルター、ランキング)を所有します。両者が メカニクス で競合する場合は alva スキルに従い、何を監視し、何を伝えるか で競合する場合はこのファイルに従ってください。製品目標はシグナルであり、カバレッジではありません。これまで見たことのないポートフォリオから、重要な投資シグナルを市場ノイズから分離します。

核となる原則:すべてのしきい値は相対的

ハードコードされたパーセンテージしきい値はありません。 NVDA が 3% 下落するのは普通の日ですが、コカ・コーラが 3% 下落するのはニュースです。このスキルは未知のポートフォリオでも機能します。なぜなら、すべての異常テストは その保有銘柄自身の統計的ベースライン および 市場とそのセクターがその日にどう動いたか に対して測定され、セットアップ時に計算されるからです。これが再利用性エンジン全体です。これを正しく理解すれば、残りは自然に機能します。

ビルド順序 (Alva プリミティブへのマッピング)

alva スキルのセッション開始とゲートに従ってください。スキル固有の順序は以下の通りです:

  1. インテーク — 保有銘柄、ウェイト、意図、アラートチャネル、時間軸を解析します。
  2. プロファイルフィード — 保有銘柄ごとのベースライン + ベンチマークルーティング(再利用性エンジン)。最初に構築します。すべてのしきい値はこれを読み取ります。
  3. ウォッチフィード — 監視レイヤーで、スコア化されたシグナルを出力します。
  4. Playbook インターフェース — ライブリード HTML、4つのタブ(Watch / Incident / Theory / Formulas — §インターフェース 参照)。Theory と Formulas は必須であり、オプションではありません。
  5. アラートサイドカー — notify/message プッシュ、デフォルトで静か、ディープリンク付き。
  6. リリース + 検証 — リリース、スクリーンショット、アラート有効化、実際の実行を確認します。

すべての数値には Alva Data Skills を、永続化には @alva/feed を、ポートフォリオレベルの計算(ウェイト、ドローダウン、相関、寄与度)には FeedAltra を、一行ナラティブには @alva/pi を、プッシュフローには references/push-notifications.md を使用します。金融価値を HTML にハードコードしないでください。


ステップ 0 — オンボーディングと事前チェック(これを最初に実行し、一行から始める)

ユーザーは、何もセットアップされていない新しいローカルエージェント からこのスキルを呼び出し、「私の NVDA、TSLA、AAPL を監視して、大きな動きがあったら知らせて」 と一行言うことがよくあります。その一行から、セットアップとビルド全体を積極的に実行してください。ユーザーに手動で設定させたり、デフォルト化できる仕様を尋ねたりしないでください。ビルドの前に、3つの前提条件を静かに確認し、不足している場合のみ ユーザーをガイドします:

  1. ベースの Alva スキルが利用可能か? このスキルは builds_on: alva を宣言しており、Alva のプラットフォームプリミティブ(フィード、Playbook リリース、プッシュ)を必要とします。エージェントが Alva ビルドツールにアクセスできない場合、ユーザーに一度インストールしてから再試行するよう伝えます: npx skills add https://github.com/alva-ai/skills。
  2. Alva にサインインしているか? Playbook は ユーザー自身のアカウントの下で 作成され、アラートは ユーザー自身 に配信されるため、認証されている必要があります(確認は alva whoami、未認証なら alva auth login)。必要に応じて一度だけログインをガイドします。
  3. アラートチャネルが接続されているか? プッシュをスマートフォンに届けるには、alva.ai/settings でリンクされた active_channel(Discord / Telegram / Slack)が必要です。alva whoami で確認します(active_channel フィールド)。ない場合は今すぐメモしますが、ビルドをブロックしないでください — 最初のアラート準備完了直後に再度リマインダーを送ります。

次に、そのままビルドします:一行を解析し(ステップ 1)、プロファイル + ウォッチフィードとインターフェースを立ち上げ、ユーザーにアラートを配線します(アラート → このユーザーに配信 を参照)。次の一行で報告します:「NVDA/TSLA/AAPL を監視中 · インターフェース: <リンク> · アラート → あなたの <チャネル>。」 最大 1 つの ブロッキング質問をし、それが本当に曖昧な場合のみにしてください。その他はすべてデフォルト化します(均等ウェイト、標準感度、長期ホライズン)。

ステップ 1 — インテーク(未知のポートフォリオで機能)

抽出:ティッカー/資産、株式数または想定元本、ウェイト、コストベース、監視スタイル、アラートチャネル、タイムゾーン、時間軸。

推奨されるゼロエントリーパス — ユーザーの実際のポートフォリオを取得します。 Alva にはネイティブの Portfolio モジュール(TREX + SnapTrade を介した接続された証券/暗号口座)があります。ユーザーが 「私のポートフォリオを監視して」 と言い、リンクされたアカウントがある場合、ティッカーを入力するようユーザーに求めず、ポジションを直接読み取り、監視セットを設定します:

  1. alva portfolio accounts → 接続されたアカウントの一覧を表示(trex:… / snaptrade:…)。複数ある場合はどれか尋ねるか、すべて(ユニオン)を監視します。
  2. alva portfolio summary --account-id <id> → 保有銘柄 + 残高。各ポジションを {symbol, name, weight (時価評価額 / 合計から), sector} にマッピングし、監視セット設定に書き込みます(以下参照)。ウェイトは実際の残高から 無料で 取得されるため、ランキングは均等ウェイトではなく正確になります。
  3. 監視前に、解決されたリストを一行でユーザーに確認します。その後、フィードはすべての銘柄名を自動プロファイルし(ステップ 2)、セオシスプロンプトが続きます。
  4. リクエストに応じて同期 — 「私のポートフォリオを同期して」でアカウントを再読み込みし、設定と差分(新しい買いは追加、完全な売却は削除)を取得します。alva portfolio activities で最近の取引履歴を取得します。これはユーザー自身の ID でエージェント上で実行されます。ヘッドレスフィードはユーザーを偽装できないため、リフレッシュはユーザーがトリガーする(または保存された制限付きトークンを介して)必要があり、サイレントなバックグラウンドプルは決して行われません。アカウントがリンクされていない場合、以下の手動インテークにフォールバックします。

不足時のデフォルト:

  • ウェイト — 均等ウェイト。ポートフォリオへの影響推定値には「概算」とラベル付けします。ウェイトはランキングにのみ影響し、異常が検出されるかどうかには影響しません。
  • 監視スタイル — 標準(P0 即時、P1 消化済み、P2 インターフェースのみ)。
  • 時間軸 — 長期。ファンダメンタルズ、イベント、流動性、提出書類、ポートフォリオへの影響を、小さなテクニカルな動きよりも重視します。
  • 曖昧なティッカー — getStockCompanyDetail を使用して、最も可能性の高い米国上場証券に解決します。最大 1 つ のブロッキング質問をし、曖昧さが資産タイプや監視テンプレートを変更する場合のみにします。

シンボルが解決できない場合は、黙って無視せず、ユーザーに伝えて残りを続行します。

表明されたセオシスを取得します。 ユーザーが何かを保有する 理由 を述べた場合(「MSTR はレバレッジド BTC プレイとして」「NVDA は半導体に勝つため」)、それを解析し、保有銘柄ごとのセオシス(保有銘柄 · 関係 · 参照 · 方向性)として保存します。これはセオシスリンク監視(§セオシスリンク)を駆動します。オプションであり、なければデフォルトの市場モデルが適用されるだけです。

監視セットはユーザー所有の設定(動的な追加/削除)

監視対象ティッカーのリストは ハードコードされていません。ユーザーが所有する設定です(例:~/feeds/pw-config/v1/holdings.json:[{symbol, name, weight, sector, thesis?}])。接続された Alva Portfolio(§ステップ 1 ゼロエントリーパス)から 自動的にシード することも、手動で入力することもできます。フィードは 実行時にこれを読み取る ため、監視対象を変更するのにコード変更は必要ありません:

  • いつでも追加/削除 — 2つの方法、同じ設定。 (a) エージェントに話しかける(「COIN も監視して」「TSLA の監視をやめて」)。設定を編集します。(b) Playbook UI で行う:登録された UDF(updateWatchlist) により、検索ボックスでティッカーを追加し、チップの ✕ で削除でき、設定に直接書き込みます(無料。未認証の閲覧者にはサインインメッセージが表示されます)。追加時に、UDF は 新しいティッカーの σ分析をその場で計算 して返すため、インターフェースは追加された銘柄名の変動/z_idio/ティアを即座に表示します。完全なプロファイリングとアラートは次回のスケジュール実行時に続きます。ライブ検証済み:NVDA/TSLA/AAPL/MSTR → +COIN(エビデンスがライブ計算され、セオシスが自動適用)→ −TSLA(設定編集と UDF の両方で)。
  • 新しい銘柄名は自動的に完全な処理を受けます — 新しく追加されたティッカーはプロファイルされ(自身の σ/β/σ_ε ベースライン)、新規上場の場合はコールドスタートパス(§コールドスタート)に入ります。これにより、再利用性の要件が運用可能になります。スキルはユーザーが指定した任意のセットで機能し、そのセットはライブです。
  • ウェイトはオプション(デフォルトは均等ウェイト)。保有銘柄ごとの thesis はオプションです。

ステップ 2 — プロファイルフィード(再利用性エンジン)

何かを監視する前に、上記の設定から 保有銘柄ごとのプロファイル を永続化するフィードを 1 つ構築し、Data Skills の履歴を使用します。これにより、しきい値が相対的になり、ルーティングが正しくなります。

保有銘柄ごとに、以下を計算して保存します:

フィールドソース/メソッド用途
asset_type会社/資産詳細適用されるテンプレート
sector, industry会社詳細セクターテンプレート + ベンチマーク
sigma_ewma, sigma_mad, sigma_epsEWMA(λ=0.94) ボラティリティ、1.4826·MAD ロバストフロア、残差(固有)ボラティリティ √(σ²−β²σ_m²)zスコアの分母(§ステップ 4)
avg_vol_20d, avg_dollar_vol_20d(時間帯対応の場合は日中)出来高履歴RVOL / 回転率 / 流動性
free_float所有権データ回転率の分母
beta, primary_benchmark, sector_benchmark, peer_basketベンチマークに対する回帰(付録 A 参照)市場/セクターノイズ除去
liquidity_bucket, volatility_bucket, market_cap_bucket派生確認の厳格さ
options_available, short_interest_available, crypto_exposure機能フラグアクティブ化される確認機能
earnings_next, ex_div_next, event_calendarカレンダーエンドポイントイベントスケジューリング
week52_high, week52_lowローソク足マイルストーンシグナル

スローなペースでリフレッシュ(毎日/毎週)。すべてのダウンストリームしきい値はこのフィードから読み取られます。ポートフォリオを変更すると、同じルールが自動的に再適合します。新規上場または薄商いの銘柄名については、より強力な証拠を要求し、信頼度を低くマークします。

認識すべき資産タイプ: 普通株式、ADR、ETF/ETP、クローズドエンド型ファンド、REIT、BDC、MLP、優先株式、SPAC/デSPAC、暗号資産、暗号関連株式(取引所、マイナー、トレジャリー企業、ブローカー、ステーブルコイン/ペイメントプロキシ — COIN、MSTR、MARA、RIOT、CLSK、HOOD)、その他の上場証券。保有銘柄がテンプレートにまたがる場合、重要なものをすべて適用し、主要なドライバーをマークします。

ステップ 3 — 監視対象(階層型モデル)

データソースではなく、投資家が気にする理由 で整理します。普遍的なモニターは、データが存在する場合にすべての保有銘柄に適用されます。テンプレートは資産タイプ固有のインテリジェンスを追加します。

レイヤー A — 価格、相対パフォーマンス、流動性(日中/時間ごとのポーリング)

シグナル定義(相対的)役割
異常な変動z = 日次リターン / sigma_20d(5d/1m/YTD、ギャップ、寄り付きから引けまで)コア
残差変動残差 = ティッカーリターン − 説明される市場セクター変動。市場+セクターが変動の 半分未満 しか説明しない場合にフラグコア
セクター相対z of (ティッカーリターン − セクターベンチマークリターン) ≥ 2.0コア
出来高異常RVOL = 出来高 / 平均出来高(時間帯調整済み)。2倍で注目、3倍で強い、5倍以上で大きなカタリスト。5倍以上は多くの場合クライマックス/疲弊であり、継続ではない — 価格方向とともに読む確認
回転率出来高 / 浮動株式数 ≥ 60日中央値の 2倍 または 90パーセンタイル超。高回転率 + 好材料後の上昇失敗 = ディストリビューション確認
流動性ストレス流動性のある銘柄でビッドアスクスプレッドが 90パーセンタイル超。停止、LULD、SSR確認
レンジブレイク20/50/200日線ブレイク 出来高確認を伴う、または 52週高値/安値、史上最高値弱い
スロートレンドN 連続下落日、または 5日累積変動 > 2σ(日次では有意でないが、累積的に有意)スロー

レイヤー B — イベントと提出書類(カレンダー/提出書類駆動。多くは事前に把握可能)

  • 決算:事前アナウンスリマインダー(T−1/2)+ 結果 vs 予想 + ガイダンス変更。
  • 配当 / 株式分割 / スピンオフ / 権利落ち日。指数構成変更。ETF リバランス。
  • 提出書類と所有権: 8-K 重要イベント、10-Q/10-K、ゴーイングコンサーン文言、監査人変更/遅延提出、訂正、資金調達/希薄化(S-1/S-3/424B/ATM、転換社債、二次公募)、Form 4 インサイダー取引、13D アクティビストポジション。アップグレード:市場でのインサイダー買い、経営幹部のクラスター買い、キャッシュバーニング銘柄の資金調達、アクティビスト 13D。構築済み (v1): スマートマネーポジショニング オーバーレイは、裁量的な市場での Form-4 買い/売り(10b5-1 除外)をカウントします。インサイダー(または CEO)のクラスター買いは、確認 + 価格が弱い場合の強気ダイバージェンスのヘッドアップです。ポートフォリオコンテキストとして表示され、銘柄ごとのプッシュ通知は行われません。ダウングレード:定型的な 10b5-1 売却と機械的な分割/配当調整。
  • ロックアップ / PIPE アンロック(SPAC)、償還リスク。
  • マクロカレンダー(FOMC、CPI、金利、ドル、原油)ポートフォリオが感応的な場合のみ(高ベータまたは金利/コモディティにエクスポージャーがあるセクター)、または複数の保有銘柄がそのエクスポージャーを共有する場合。それ以外はこのユーザーにとってノイズです。

レイヤー C — 情報とナラティブ(ニュース駆動、事前に把握不可能)

  • 重要な企業ニュース:M&A、訴訟、規制措置、経営陣交代、主要製品の失敗/リコール(Data Skills ニュース + コンテキストのための unified_search)。
  • 予想とレーティング変更 — 集約、決して個別ではありません。1 つの小さな改訂はノイズです。同じ方向への広範な改訂のクラスター、または 予想/セオシスの変更を伴う 目標株価の変更はシグナルです。
  • 複数の信頼できる情報源を要求する。転載された古いニュース、単一情報源の噂、一般的な市場コメントは抑制します。ソーシャルベロシティは弱いシグナルにすぎません。
  • 半導体サイクル(TrendForce DXI メモリ指数) — 構築済み (v1):セクターコンテキスト オーバーレイとして。DXI トレンドと 30/60日移動平均線との関係 = 半導体保有銘柄にマッピングされるメモリサイクルの追い風/逆風(メモリ銘柄に最も直接的。GPU/AI には HBM を介した広範なサイクル読み取り)。セクターファンドフロー(ローテーション)とコンセンサス予想修正モメンタムは、従来の確認機能として指定されています。
  • 予測市場(Polymarket)を構造化されたイベントシグナルとして — 流動性のある市場(FRB 決定、選挙、一部カタリスト)を持つイベントの場合、イベント確率の急激な変動は、定量化された、多くの場合早期の価格再設定です。

ステップ 4 — シグナルランキングとフィルタリング

すべての検出されたシグナルはスコア化され、ランク付けされる必要があります。P0(即時プッシュ)、P1(消化済みプッシュ)、P2(インターフェースのみ、プッシュなし)の 3 段階の優先順位システムを使用します。

優先順位は、シグナルの種類だけでなく、ポートフォリオコンテキスト(ウェイト、エクスポージャーの集中、相関)によっても決定されます。

ステップ 5 — セオシスリンク監視

このスキルの独自の特徴は、ユーザーが表明した投資セオシスをシグナル検出に結び付ける機能です。セオシスが保存されている場合(例:「MSTR をレバレッジド BTC プレイとして保有」)、関連するデータソース(この場合、BTC の価格、BTC のボラティリティ、MSTR のプレミアム/ディスカウント)が監視され、セオシスと矛盾する動きは、市場ベースの動きよりも高い優先順位が与えられます。

ステップ 6 — アラートと配信

アラートはデフォルトで静かであり、P0 イベントのみが即座にプッシュされます。P1 イベントは定期的にダイジェストされます。P2 イベントはインターフェースにのみ表示されます。各プッシュ通知には、関連する Playbook カードへのディープリンクが含まれます。


このドキュメントは、コミュニティによって維持されているスキルの設計図です。Alva のビルドメカニクスについては、alva スキルを参照してください。

関連スキル