Communitygithub.com

george351419-sys/Portfolio-Watch-Skill

Eine wiederverwendbare Portfolio-Überwachungsfähigkeit für Alva – verwandelt jedes Portfolio in ein Live-Dashboard mit leisen, priorisierten Benachrichtigungen. Beobachtet die Kauf-These, nicht nur den Markt. Basierend auf Alva, backgetestet mit 5-Jahres-Daten und live.

Was ist Portfolio-Watch-Skill?

Diese Fähigkeit (Skill) verwandelt die natürliche Spracheingabe eines Benutzers, wie zum Beispiel „beobachte meine NVDA, TSLA, AAPL und benachrichtige mich bei großen Bewegungen

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Portfolio Watch

Verwandle eine einzeilige Anfrage wie "beobachte meine NVDA, TSLA, AAPL und benachrichtige mich, wenn etwas Großes passiert" in ein gehostetes Portfolio Watch Playbook: eine Schnittstelle, die der Benutzer öffnet, um zu sehen, was mit seinen Beständen passiert, plus leise, priorisierte Push-Benachrichtigungen, die sein Telefon erreichen und tief zur passenden Karte verlinken.

Diese Fähigkeit ist eine Methodik-Vorlage. Sie ersetzt nicht Alvas Bau-Mechaniken – sie treibt sie an. Alva besitzt die Grundelemente (Data Skills, Laufzeit-Feeds, Altra, alpi, Playbook-Veröffentlichung, Push). Diese Fähigkeit besitzt das Monitoring-Urteilsvermögen: Dimensionen, Schwellenwerte, Rauschfilter und Priorisierung. Wenn die beiden bei der Mechanik in Konflikt geraten, folge der alva-Fähigkeit; bei was zu beobachten und was zu sagen ist, folge dieser Datei. Das Produktziel ist Signal, nicht Abdeckung – trenne materielle Investitionssignale vom Marktrauschen für ein Portfolio, das sie noch nie gesehen hat.

Kernprinzip: Jeder Schwellenwert ist relativ

Es gibt keine fest codierten prozentualen Schwellenwerte. NVDA -3 % ist ein normaler Tag; Coca-Cola -3 % ist eine Nachricht. Die Fähigkeit funktioniert bei einem unbekannten Portfolio, weil jeder Anomalietest anhand der eigenen statistischen Baseline dieses Bestands und anhand dessen, was der Markt und sein Sektor heute gemacht haben, gemessen wird, berechnet bei der Einrichtung. Dies ist der gesamte Wiederverwendbarkeitsmotor – mach das richtig und der Rest folgt.

Bau-Reihenfolge (auf Alva-Primitive abbilden)

Befolge die Sitzungsstart- und Gate-Regeln der alva-Fähigkeit. Die fähigkeitsspezifische Reihenfolge ist:

  1. Aufnahme – Bestände, Gewichtungen, Absicht, Benachrichtigungskanal, Zeithorizont parsen.
  2. Profil-Feed – Baseline pro Bestand + Benchmark-Routing (der Wiederverwendbarkeitsmotor). Baue ihn zuerst; alle Schwellenwerte lesen daraus.
  3. Watch-Feed(s) – die Überwachungsebenen, die bewertete Signale ausgeben.
  4. Playbook-Schnittstelle – Live-lesbares HTML, vier Registerkarten (Watch / Incident / Theory / Formulas – siehe §Die Schnittstelle); Theorie + Formeln sind erforderlich, nicht optional.
  5. Alert-Seitenwagen – notify/message-Push, leise standardmäßig, tief verlinkt.
  6. Veröffentlichen + Verifizieren – veröffentlichen, Screenshot machen, Benachrichtigung aktivieren, einen echten Durchlauf bestätigen.

Verwende Alva Data Skills für jede Zahl, @alva/feed für Persistenz, FeedAltra für Portfolio-Mathematik (Gewichtungen, Drawdown, Korrelation, Beitrag), @alva/pi für einzeilige Narrative und den Push-Fluss aus references/push-notifications.md. Codiere niemals Finanzwerte fest in HTML.


Schritt 0 – Onboarding & Preflight (zuerst ausführen, von einer Zeile aus)

Ein Benutzer ruft diese Fähigkeit oft von einem frischen lokalen Agenten ohne Einrichtung auf und sagt eine Zeile – "beobachte meine NVDA, TSLA, AAPL und benachrichtige mich bei großen Bewegungen." Von dieser Zeile aus treibe proaktiv das gesamte Setup und den Bau voran – zwinge den Benutzer nicht, Dinge manuell zu konfigurieren, und frage nicht nach Spezifikationen, die du standardmäßig vorgeben kannst. Überprüfe vor dem Bauen still drei Voraussetzungen und führe den Benutzer nur dort, wo etwas fehlt : ~~~~~~

  1. Basis-Alva-Fähigkeit verfügbar? Diese Fähigkeit deklariert builds_on: alva und benötigt Alvas Plattform-Primitive (Feeds, Playbook-Veröffentlichung, Push). Wenn der Agent die Alva-Bauwerkzeuge nicht erreichen kann, sage dem Benutzer, er solle sie einmal installieren und dann erneut versuchen: npx skills add https://github.com/alva-ai/skills.
  2. Bei Alva angemeldet? Das Playbook wird unter dem eigenen Konto des Benutzers erstellt und Benachrichtigungen werden an ihn gesendet, daher muss er authentifiziert sein (alva whoami zum Überprüfen; alva auth login falls nicht). Leite die einmalige Anmeldung bei Bedarf an.
  3. Benachrichtigungskanal verbunden? Damit Pushes das Telefon erreichen, benötigt der Benutzer einen active_channel (Discord / Telegram / Slack), der unter alva.ai/settings verknüpft ist. Überprüfe alva whoami (active_channel); falls keiner vorhanden ist, notiere es jetzt, aber blockiere den Bau nicht – erinnere erneut direkt nach der ersten fertigen Benachrichtigung.

Dann baue es einfach: parse die eine Zeile (Schritt 1), richte die Profil- + Watch-Feeds und die Schnittstelle ein und verbinde Benachrichtigungen mit dem Benutzer (siehe Die Benachrichtigungen → An diesen Benutzer liefern). Melde in einer Zeile zurück: "Beobachte NVDA/TSLA/AAPL · Schnittstelle: <link> · Benachrichtigungen → dein <kanal>." Stelle höchstens eine blockierende Frage, und nur, wenn wirklich nicht eindeutig. Standardisiere alles andere (gleiche Gewichtung, Standard-Empfindlichkeit, langer Zeithorizont).

Schritt 1 – Aufnahme (funktioniert bei einem unbekannten Portfolio)

Extrahiere: Ticker/Werte, Aktien oder Nominalwert, Gewichtungen, Kostenbasis, Beobachtungsstil, Benachrichtigungskanal, Zeitzone, Zeithorizont.

Bevorzugter Zero-Entry-Pfad – das echte Portfolio des Benutzers abrufen. Alva hat ein natives Portfolio-Modul (verbundene Broker- / Krypto-Konten über TREX + SnapTrade). Wenn der Benutzer "beobachte mein Portfolio" sagt und ein verbundenes Konto hat, bitte ihn nicht, Ticker einzutippen – lies die Positionen direkt und fülle die überwachte Menge:

  1. alva portfolio accounts → liste verbundene Konten auf (trex:… / snaptrade:…). Wenn mehrere vorhanden sind, frage, welches (oder beobachte alle, vereinigt).
  2. alva portfolio summary --account-id <id> → Bestände + Guthaben. Bilde jede Position auf {symbol, name, weight (from market value / total), sector} ab und schreibe sie in die überwachte Mengenkonfiguration (unten). Gewichtungen kommen kostenlos von echten Guthaben, daher ist die Priorisierung exakt anstatt gleichgewichtet.
  3. Bestätige die aufgelöste Liste dem Benutzer in einer Zeile vor der Überwachung; dann profiliert der Feed automatisch jeden Namen (§Schritt 2) und Thesen-Prompts folgen.
  4. Auf Anfrage synchronisieren – "synchronisiere mein Portfolio" liest Konten erneut und differenziert gegen die Konfiguration (neue Käufe hinzugefügt, vollständige Verkäufe entfernt); alva portfolio activities liefert die letzten Handelsaktivitäten. Dies läuft auf dem Agenten unter der eigenen Identität des Benutzers – ein kopfloser Feed kann den Benutzer nicht imitieren, daher ist die Aktualisierung benutzergetriggert (oder über ein gespeichertes eingeschränktes Token), niemals ein stiller Hintergrundabruf. Wenn kein Konto verbunden ist, falle auf die manuelle Aufnahme unten zurück.

Standardwerte, wenn nicht vorhanden:

  • Gewichtungen – gleiche Gewichtung; kennzeichne Portfolio-Auswirkungsschätzungen als ungefähr. Gewichtungen beeinflussen nur die Priorisierung, niemals, ob eine Anomalie erkannt wird.
  • Beobachtungsstil – Standard (P0 sofort, P1 aufbereitet, P2 nur Schnittstelle).
  • Zeithorizont – langfristig; betone Fundamentaldaten, Ereignisse, Liquidität, Einreichungen und Portfolio-Auswirkung gegenüber kleinen technischen Bewegungen.
  • Mehrdeutiger Ticker – löse mit getStockCompanyDetail zum wahrscheinlichsten US-gelisteten Wertpapier auf. Stelle höchstens eine blockierende Frage, und nur, wenn die Mehrdeutigkeit den Asset-Typ oder die Überwachungsvorlage ändert.

Löse nichts still auf: wenn ein Symbol nicht aufgelöst werden kann, informiere den Benutzer und fahre mit dem Rest fort.

Erfasse eine genannte These. Wenn der Benutzer sagt, warum er etwas hält ("MSTR als gehebelten BTC-Play", "NVDA schlägt die Halbleiter"), parsen und speichere es als These pro Bestand (Bestand · Beziehung · Referenz · Richtung) – es treibt die these-verknüpfte Überwachung (§Thesen-Verknüpft). Optional; Fehlen bedeutet nur das Standardmarktmodell.

Die überwachte Menge ist eine benutzereigene Konfiguration (dynamisches Hinzufügen/Entfernen)

Die Liste der überwachten Ticker ist nicht fest codiert – es ist eine Konfiguration, die der Benutzer besitzt (z. B. ~/feeds/pw-config/v1/holdings.json: [{symbol, name, weight, sector, thesis?}]). Sie kann automatisch aus dem verbundenen Alva Portfolio übernommen werden (§Schritt 1 Zero-Entry-Pfad) oder von Hand ausgefüllt werden. Die Feeds lesen sie zur Laufzeit, daher erfordert das Ändern der überwachten Elemente niemals eine Codeänderung:

  • Jederzeit hinzufügen/entfernen – zwei Wege, gleiche Konfiguration. (a) Mit dem Agenten sprechen ("überwache auch COIN", "beende die Überwachung von TSLA"); er bearbeitet die Konfiguration. (b) Es in der Playbook-Benutzeroberfläche tun: eine registrierte UDF (updateWatchlist) ermöglicht es dem Suchfeld, einen Ticker hinzuzufügen und ein Chip-✕ einen zu entfernen, indem direkt in die Konfiguration geschrieben wird (kostenlos; nicht authentifizierte Betrachter sehen eine Aufforderung zur Anmeldung). Beim Hinzufügen berechnet die UDF die σ-Analyse des neuen Tickers sofort und gibt sie zurück, sodass die Schnittstelle sofort die Bewegung/z_idio/Stufe des hinzugefügten Namens anzeigt; vollständige Profilierung + Benachrichtigungen folgen beim nächsten geplanten Durchlauf. Verifiziert live: NVDA/TSLA/AAPL/MSTR → +COIN (Beweise live berechnet, These automatisch angewendet) → −TSLA, durch Konfigurationsbearbeitung und durch UDF.
  • Neue Namen werden automatisch vollständig behandelt – ein frisch hinzugefügter Ticker wird profiliert (seine eigene σ/β/σ_ε-Baseline), und wenn er neu notiert ist, geht er in den Kaltstartpfad (§Kaltstart). Dies macht die Wiederverwendbarkeitsanforderung operativ: Die Fähigkeit funktioniert mit jeder Menge, die der Benutzer nennt, und die Menge ist live.
  • Gewichtungen sind optional (gleiche Gewichtung als Standard); thesis pro Bestand ist optional.

Schritt 2 – Profil-Feed (der Wiederverwendbarkeitsmotor)

Bevor du etwas beobachtest, baue einen Feed, der ein Profil pro Bestand aus der obigen Konfiguration mit Data Skills-Verlauf speichert. Dies macht Schwellenwerte relativ und das Routing korrekt.

Pro Bestand berechnen und speichern:

FeldQuelle/MethodeVerwendet für
asset_typeUnternehmens-/Asset-Detailwelche Vorlagen gelten
sector, industryUnternehmensdetailSektorvorlage + Benchmark
sigma_ewma, sigma_mad, sigma_epsEWMA(λ=0.94)-Vol, 1.4826·MAD robuste Untergrenze und residuale (idiosynkratische) Vol √(σ²−β²σ_m²)Z-Score-Nenner (§Schritt 4)
avg_vol_20d, avg_dollar_vol_20d (tageszeitabhängig, wenn intraday)VolumenhistorieRVOL / Umschlag / Liquidität
free_floatEigentumsdatenUmschlag-Nenner
beta, primary_benchmark, sector_benchmark, peer_basketRegression auf Benchmarks (siehe Anhang A)Markt-/Sektor-Rauschentfernung
liquidity_bucket, volatility_bucket, market_cap_bucketabgeleitetBestätigungsstrenge
options_available, short_interest_available, crypto_exposureFähigkeitsflagswelche Bestätiger aktivieren
earnings_next, ex_div_next, event_calendarKalender-EndpunkteEreignisplanung
week52_high, week52_lowKerzenMeilensteinsignale

Aktualisierung in langsamem Rhythmus (täglich/wöchentlich). Alle nachgelagerten Schwellenwerte lesen aus diesem Feed – ändere das Portfolio und dieselben Regeln passen sich automatisch an. Für neu notierte oder dünn gehandelte Namen stärkere Beweise anfordern und Vertrauen niedriger bewerten.

Zu erkennende Asset-Typen: Stammaktien, ADR, ETF/ETP, Closed-End-Fonds, REIT, BDC, MLP, Vorzugsaktien, SPAC/de-SPAC, Krypto-Asset, krypto-verknüpfte Aktien (Börsen, Miner, Treasury-Unternehmen, Broker, Stablecoin/Zahlungs-Proxies — COIN, MSTR, MARA, RIOT, CLSK, HOOD), andere gelistete Wertpapiere. Wenn ein Bestand mehrere Vorlagen umfasst, wende alle wesentlichen an und kennzeichne den primären Treiber.

Schritt 3 – Was zu beobachten ist (geschichtetes Modell)

Organisiere nach warum ein Investor sich kümmert, nicht nach Datenquelle. Universelle Überwachungen gelten für jeden Bestand, wenn Daten vorhanden sind; Vorlagen fügen asset-spezifische Intelligenz hinzu.

Ebene A – Preis, relative Performance, Liquidität (intraday/stündlich abfragen)

SignalDefinition (relativ)Rolle
Abnormale Bewegungz = day_return / sigma_20d (auch 5d/1m/YTD, Gap, Open-to-Close)Kern
Residuale Bewegungresidual = ticker_return − explained_market_sector_move; flaggen, wenn Markt+Sektor weniger als die Hälfte der Bewegung erklärenKern
Sektor-relativz von (ticker_return − sector_benchmark_return) ≥ 2.0Kern
VolumenanomalieRVOL = vol / avg_vol (tageszeitangepasst); 2× bemerkenswert, 3× stark, 5×+ großer Katalysator. 5×+ ist oft klimaktisch/Erschöpfung, nicht Fortsetzung – mit Preisrichtung lesenBestätiger
Umschlagvol / free_float ≥ 2× 60d-Median oder > 90. Perzentil; hoher Umschlag + gescheiterter Anstieg nach guten Nachrichten = VerteilungBestätiger
LiquiditätsstressGeld-Brief-Spanne > 90. Perzentil für einen liquiden Namen; Handelsaussetzungen, LULD, SSRBestätiger
Bereichsbruch20/50/200-Tage-Bruch mit Volumenbestätigung, oder 52-Wochen-Hoch/Tief, Allzeithochschwach
Langsamer TrendN aufeinanderfolgende Abwärtstage, oder kumulative 5-Tage-Bewegung > 2σ (nicht täglich signifikant, kumulativ signifikant)langsam

Ebene B – Ereignisse & Einreichungen (kalender-/einreichungsgetrieben; viele sind früh bekannt)

  • Gewinne: Vorkündigungserinnerung (T−1/2) + Ergebnis vs. Schätzung + Guidance-Änderung.
  • Dividenden / Aktiensplits / Spin-offs / Ex-Tag; Indexänderungen; ETF-Neuausrichtung.
  • Einreichungen & Eigentum: 8-K wesentliche Ereignisse, 10-Q/10-K, Going-Concern-Sprache, Prüferwechsel/verspätete Einreichung, Neudarstellungen, Finanzierung/Verwässerung (S-1/S-3/424B/ATM, Wandelanleihen, Zweitplatzierungen), Form 4 Insider-Transaktionen, 13D aktivistische Beteiligungen. Aufwerten: Offene-Markt-Insiderkäufe, gebündelte Führungskäufe, Finanzierung für bargeldverbrennende Namen, aktivistisches 13D. Integriert (v1): Eine Smart-Money-Positionierungs-Überlagerung zählt diskretionäre Offene-Markt-Form-4-Käufe/-Verkäufe (10b5-1 ausgeschlossen); ein Cluster von Insidern (oder der CEO), die kaufen, ist ein Bestätiger + ein bullischer Divergenz-Hinweis, wenn der Preis schwach ist – als Portfolio-Kontext angezeigt, niemals als per-Aktie-Push. Abwerten: Routine-10b5-1-Verkäufe und mechanische Split-/Dividendenanpassungen.
  • Lockup / PIPE-Entsperrungen (SPACs), Rücknahmerisiko.
  • Makro-Kalender (FOMC, CPI, Zinsen, Dollar, Öl) nur, wenn das Portfolio empfindlich ist (hohes Beta oder zins-/rohstoffexponierte Sektoren) oder mehrere Bestände die Exposition teilen – sonst ist es Rauschen für diesen Benutzer.

Ebene C – Information & Narrative (nachrichtenbasiert, nicht im Voraus bekannt)

  • Wesentliche Unternehmensnachrichten: M&A, Rechtsstreitigkeiten, regulatorische Maßnahmen, Führungswechsel, größeres Produktversagen/Rückruf (Data Skills News + unified_search für Kontext).
  • Schätzungs- & Ratingänderungen – aggregiert, niemals pro Einzelposten: eine kleine Revision ist Rauschen; ein breiter Cluster von gleichgerichteten Revisionen oder eine Zieländerung mit einer Schätzungs-/Thesenänderung ist ein Signal.
  • Mehrere glaubwürdige Quellen erfordern; unterdrücke erneut veröffentlichte alte Nachrichten, Ein-Quellen-Gerüchte und generische Marktkommentare. Soziale Dynamik ist nur ein schwaches Signal.
  • Halbleiterzyklus (TrendForce DXI-Speicherindex) – integriert (v1) als Sektorkontext-Überlagerung: DXI-Trend vs. seine 30/60-Tage-MAs = ein Speicherzyklus-Rückenwind/Gegenwind, der auf Halbleiterbestände abgebildet wird (am direktesten für Speichernamen; ein breiter Zyklus für GPU/AI über HBM). Sektor-Fondsflüsse (Rotation) und Konsens-Schätzungs-Revisionsdynamik werden als konventionelle Bestätiger spezifiziert.
  • Prognosemärkte (Polymarket) als strukturiertes Ereignissignal – für Ereignisse mit einem liquiden Markt (Fed-Entscheidungen, Wahlen, einige Katalysatoren) ist eine starke Bewegung der Ereigniswahrscheinlichkeit eine quantifizierte, oft frühe Neubewertung. U…

[gekürzt für Übersetzung]

Verwandte Skills