Portfolio Watch
「私の NVDA、TSLA、AAPL を監視して、何か大きなことが起きたら知らせて」のような一行のリクエストを、ホスト型の Portfolio Watch Playbook に変換します。これは、ユーザーが保有銘柄の状況を確認できるインターフェースと、スマートフォンに届き、該当カードにディープリンクする静かな優先順位付きプッシュ通知を提供します。
このスキルは 方法論の設計図 です。Alva の構築メカニズムを置き換えるのではなく、それを駆動します。Alva はプリミティブ(Data Skills、ランタイムフィード、Altra、alpi、Playbook リリース、プッシュ)を所有し、このスキルは 監視の判断(次元、しきい値、ノイズフィルター、ランキング)を所有します。両者が メカニクス で競合する場合は alva スキルに従い、何を監視し、何を伝えるか で競合する場合はこのファイルに従ってください。製品目標はシグナルであり、カバレッジではありません。これまで見たことのないポートフォリオから、重要な投資シグナルを市場ノイズから分離します。
核となる原則:すべてのしきい値は相対的
ハードコードされたパーセンテージしきい値はありません。 NVDA が 3% 下落するのは普通の日ですが、コカ・コーラが 3% 下落するのはニュースです。このスキルは未知のポートフォリオでも機能します。なぜなら、すべての異常テストは その保有銘柄自身の統計的ベースライン および 市場とそのセクターがその日にどう動いたか に対して測定され、セットアップ時に計算されるからです。これが再利用性エンジン全体です。これを正しく理解すれば、残りは自然に機能します。
ビルド順序 (Alva プリミティブへのマッピング)
alva スキルのセッション開始とゲートに従ってください。スキル固有の順序は以下の通りです:
- インテーク — 保有銘柄、ウェイト、意図、アラートチャネル、時間軸を解析します。
- プロファイルフィード — 保有銘柄ごとのベースライン + ベンチマークルーティング(再利用性エンジン)。最初に構築します。すべてのしきい値はこれを読み取ります。
- ウォッチフィード — 監視レイヤーで、スコア化されたシグナルを出力します。
- Playbook インターフェース — ライブリード HTML、4つのタブ(Watch / Incident / Theory / Formulas — §インターフェース 参照)。Theory と Formulas は必須であり、オプションではありません。
- アラートサイドカー —
notify/messageプッシュ、デフォルトで静か、ディープリンク付き。 - リリース + 検証 — リリース、スクリーンショット、アラート有効化、実際の実行を確認します。
すべての数値には Alva Data Skills を、永続化には @alva/feed を、ポートフォリオレベルの計算(ウェイト、ドローダウン、相関、寄与度)には FeedAltra を、一行ナラティブには @alva/pi を、プッシュフローには references/push-notifications.md を使用します。金融価値を HTML にハードコードしないでください。
ステップ 0 — オンボーディングと事前チェック(これを最初に実行し、一行から始める)
ユーザーは、何もセットアップされていない新しいローカルエージェント からこのスキルを呼び出し、「私の NVDA、TSLA、AAPL を監視して、大きな動きがあったら知らせて」 と一行言うことがよくあります。その一行から、セットアップとビルド全体を積極的に実行してください。ユーザーに手動で設定させたり、デフォルト化できる仕様を尋ねたりしないでください。ビルドの前に、3つの前提条件を静かに確認し、不足している場合のみ ユーザーをガイドします:
- ベースの Alva スキルが利用可能か? このスキルは
builds_on: alvaを宣言しており、Alva のプラットフォームプリミティブ(フィード、Playbook リリース、プッシュ)を必要とします。エージェントが Alva ビルドツールにアクセスできない場合、ユーザーに一度インストールしてから再試行するよう伝えます:npx skills add https://github.com/alva-ai/skills。 - Alva にサインインしているか? Playbook は ユーザー自身のアカウントの下で 作成され、アラートは ユーザー自身 に配信されるため、認証されている必要があります(確認は
alva whoami、未認証ならalva auth login)。必要に応じて一度だけログインをガイドします。 - アラートチャネルが接続されているか? プッシュをスマートフォンに届けるには、alva.ai/settings でリンクされた
active_channel(Discord / Telegram / Slack)が必要です。alva whoamiで確認します(active_channelフィールド)。ない場合は今すぐメモしますが、ビルドをブロックしないでください — 最初のアラート準備完了直後に再度リマインダーを送ります。
次に、そのままビルドします:一行を解析し(ステップ 1)、プロファイル + ウォッチフィードとインターフェースを立ち上げ、ユーザーにアラートを配線します(アラート → このユーザーに配信 を参照)。次の一行で報告します:「NVDA/TSLA/AAPL を監視中 · インターフェース: <リンク> · アラート → あなたの <チャネル>。」 最大 1 つの ブロッキング質問をし、それが本当に曖昧な場合のみにしてください。その他はすべてデフォルト化します(均等ウェイト、標準感度、長期ホライズン)。
ステップ 1 — インテーク(未知のポートフォリオで機能)
抽出:ティッカー/資産、株式数または想定元本、ウェイト、コストベース、監視スタイル、アラートチャネル、タイムゾーン、時間軸。
推奨されるゼロエントリーパス — ユーザーの実際のポートフォリオを取得します。 Alva にはネイティブの Portfolio モジュール(TREX + SnapTrade を介した接続された証券/暗号口座)があります。ユーザーが 「私のポートフォリオを監視して」 と言い、リンクされたアカウントがある場合、ティッカーを入力するようユーザーに求めず、ポジションを直接読み取り、監視セットを設定します:
alva portfolio accounts→ 接続されたアカウントの一覧を表示(trex:…/snaptrade:…)。複数ある場合はどれか尋ねるか、すべて(ユニオン)を監視します。alva portfolio summary --account-id <id>→ 保有銘柄 + 残高。各ポジションを{symbol, name, weight (時価評価額 / 合計から), sector}にマッピングし、監視セット設定に書き込みます(以下参照)。ウェイトは実際の残高から 無料で 取得されるため、ランキングは均等ウェイトではなく正確になります。- 監視前に、解決されたリストを一行でユーザーに確認します。その後、フィードはすべての銘柄名を自動プロファイルし(ステップ 2)、セオシスプロンプトが続きます。
- リクエストに応じて同期 — 「私のポートフォリオを同期して」でアカウントを再読み込みし、設定と差分(新しい買いは追加、完全な売却は削除)を取得します。
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_eps | EWMA(λ=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 スキルを参照してください。