Communitygithub.com

Portfolio Watch

Un compétence Alva réutilisable qui transforme n'importe quel portefeuille en tableau de bord en direct avec des alertes silencieuses et classées. Surveille la thèse d'investissement, pas seulement le marché.

Qu'est-ce que Portfolio Watch ?

Portfolio Watch est une compétence Alva conçue pour surveiller un portefeuille d'actifs en temps réel, en fournissant un tableau de bord interactif à quatre onglets (Surveillance, Incident, Thèse, Formules) et des notifications push silencieuses et classées. La compétence se distingue par son approche relative des seuils d'alerte : au lieu de valeurs fixes comme 'baisse de 3%', chaque anomalie est mesurée par rapport à la volatilité historique propre à l'actif et aux mouvements du marché et du secteur, ce qui permet de l'appliquer à n'importe quel portefeuille sans configuration manuelle importante. Elle utilise les primitives d'Alva (Data Skills, flux, Altair, ALPI) pour collecter les données de prix, les événements, les dépôts réglementaires et les news, puis les analyse en couches : anomalies de prix, de volume, de liquidité, événements programmés et narratifs. Le résultat est envoyé via des alertes push vers le téléphone de l'utilisateur (Discord, Telegram, Slack) avec un lien profond vers la carte correspondante dans le tableau de bord. La compétence supporte une initialisation automatique à partir du portefeuille réel de l'utilisateur via le module Portfolio d'Alva, et sa configuration est dynamique : l'utilisateur peut ajouter ou retirer des titres via la commande vocale ou l'interface web.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait Portfolio Watch ?

Transformez une demande en une ligne comme "surveillez mon NVDA, TSLA, AAPL et prévenez-moi quand quelque chose d'important se produit" en un Playbook Portfolio Watch hébergé : une interface que l'utilisateur ouvre pour voir ce qui arrive à ses avoirs, plus des alertes push silencieuses et classées qui atteignent son téléphone et renvoient vers la carte correspondante via un lien profond.

Cette compétence est un plan directeur méthodologique. Elle ne remplace pas les mécanismes de construction d'Alva — elle les pilote. Alva possède les primitives (Skills de données, flux d'exécution, Altra, alpi, publication de playbook, push). Cette compétence possède le jugement de surveillance : dimensions, seuils, filtres de bruit et classement. En cas de conflit sur les mécanismes, suivez la compétence alva ; sur ce qu'il faut surveiller et quoi dire, suivez ce fichier. L'objectif produit est le signal, pas la couverture — séparez les signaux d'investissement matériels du bruit du marché pour un portefeuille qu'elle n'a jamais vu.

Principe Fondamental : Chaque Seuil est Relatif

Il n'y a pas de seuils de pourcentage codés en dur. NVDA en baisse de 3% est une journée normale ; Coca-Cola en baisse de 3% est une nouvelle. La compétence fonctionne sur un portefeuille inconnu parce que chaque test d'anomalie est mesuré par rapport à la propre ligne de base statistique de cette action et par rapport à ce que le marché et son secteur ont fait aujourd'hui, calculé lors de la configuration. C'est tout le moteur de réutilisabilité — faites-le correctement et le reste suivra.

Ordre de construction (correspondance avec les primitives Alva)

Suivez le début de session et les portes de la compétence alva. L'ordre spécifique à la compétence est :

  1. Réception — analyser les avoirs, les pondérations, l'intention, le canal d'alerte, l'horizon temporel.
  2. Flux de profilage — ligne de base par action + routage du benchmark (le moteur de réutilisabilité). Construisez-le en premier ; tous les seuils en découlent.
  3. Flux de surveillance — les couches de surveillance, émettant des signaux notés.
  4. Interface du Playbook — HTML lu en direct, quatre onglets (Surveillance / Incident / Thèse / Formules — voir §L'Interface) ; Thèse et Formules sont obligatoires, pas optionnels.
  5. Module complémentaire d'alerte — notification push notify/message, silencieuse par défaut, avec lien profond.
  6. Publication + vérification — publier, capture d'écran, activer l'alerte, confirmer une exécution réelle.

Utilisez les Skills de données Alva pour chaque chiffre, @alva/feed pour la persistance, FeedAltra pour les calculs au niveau du portefeuille (pondérations, drawdown, corrélation, contribution), @alva/pi pour un récit en une ligne, et le flux push de references/push-notifications.md. Ne codez jamais en dur des valeurs financières dans le HTML.


Étape 0 — Intégration & Pré-vérification (exécutez ceci en premier, à partir d'une seule ligne)

Un utilisateur invoque souvent cette compétence depuis un agent local frais sans rien configuré, et dit une seule ligne — "surveillez mon NVDA, TSLA, AAPL et prévenez-moi des gros mouvements." À partir de cette ligne, pilotez de manière proactive l'ensemble de la configuration et de la construction — ne les obligez pas à configurer les choses manuellement, et ne demandez pas de spécifications que vous pouvez définir par défaut. Avant de construire, vérifiez silencieusement trois prérequis et guidez l'utilisateur uniquement là où quelque chose manque :

  1. Compétence Alva de base disponible ? Cette compétence déclare builds_on: alva et a besoin des primitives de plateforme d'Alva (flux, publication de playbook, push). Si l'agent ne peut pas atteindre les outils de construction Alva, dites à l'utilisateur de les installer une fois, puis réessayez : npx skills add https://github.com/alva-ai/skills.
  2. Connecté à Alva ? Le Playbook est créé sous le propre compte de l'utilisateur et les alertes sont livrées à lui, donc il doit être authentifié (alva whoami pour vérifier ; alva auth login si ce n'est pas le cas). Guidez la connexion unique si nécessaire.
  3. Canal d'alerte connecté ? Pour que les notifications push atteignent le téléphone, l'utilisateur a besoin d'un active_channel (Discord / Telegram / Slack) lié sur alva.ai/settings. Vérifiez alva whoami (active_channel) ; si aucun, notez-le maintenant mais ne bloquez pas la construction — rappelez-le juste après que la première alerte soit prête.

Ensuite, construisez-le simplement : analysez la ligne (Étape 1), mettez en place les flux de profil + de surveillance et l'interface, et branchez les alertes à l'utilisateur (voir Les Alertes → Livrer à cet utilisateur). Faites un rapport en une ligne : "Surveille NVDA/TSLA/AAPL · interface : <lien> · alertes → votre <canal>." Posez au plus une question bloquante, et seulement si c'est vraiment ambigu. Définissez tout le reste par défaut (pondération égale, sensibilité Standard, horizon long).

Étape 1 — Réception (fonctionne sur un portefeuille inconnu)

Extrayez : tickers/actifs, actions ou notionnel, pondérations, prix de revient, style de surveillance, canal d'alerte, fuseau horaire, horizon temporel.

Chemin préféré sans saisie — récupérer le portefeuille réel de l'utilisateur. Alva dispose d'un module Portfolio natif (comptes de courtage / crypto connectés via TREX + SnapTrade). Si l'utilisateur dit "surveillez mon portefeuille" et a un compte lié, ne lui demandez pas de taper des tickers — lisez les positions directement et peuplez l'ensemble surveillé :

  1. alva portfolio accounts → liste des comptes connectés (trex:… / snaptrade:…). S'il y en a plusieurs, demandez lequel (ou surveillez tous, en union).
  2. alva portfolio summary --account-id <id> → avoirs + solde. Mappez chaque position en {symbol, name, weight (market value / total), sector} et écrivez-la dans la configuration de l'ensemble surveillé (ci-dessous). Les pondérations sont gratuites à partir des soldes réels, donc le classement est exact au lieu d'être à pondération égale.
  3. Confirmez la liste résolue à l'utilisateur en une ligne avant la surveillance ; ensuite, le flux profile automatiquement chaque nom (§Étape 2) et les invites de thèse suivent.
  4. Synchronisation sur demande — "synchronisez mon portefeuille" relit les comptes et compare les différences avec la configuration (nouveaux achats ajoutés, sorties complètes supprimées) ; alva portfolio activities donne la trace des transactions récentes. Cela s'exécute sur l'Agent sous l'identité de l'utilisateur — un flux sans tête ne peut pas usurper l'identité de l'utilisateur, donc l'actualisation est déclenchée par l'utilisateur (ou via un jeton restreint stocké), jamais une extraction en arrière-plan silencieuse. Si aucun compte n'est lié, revenez à la réception manuelle ci-dessous.

Valeurs par défaut en cas d'absence :

  • Pondérations — pondération égale ; étiquetez les estimations d'impact sur le portefeuille comme approximatives. Les pondérations n'affectent que le classement, jamais la détection d'une anomalie.
  • Style de surveillance — Standard (P0 immédiat, P1 digéré, P2 interface uniquement).
  • Horizon temporel — long terme ; mettez l'accent sur les fondamentaux, les événements, la liquidité, les dépôts réglementaires et l'impact sur le portefeuille plutôt que sur les petits mouvements techniques.
  • Ticker ambigu — résolvez le titre de sécurité le plus probable coté aux États-Unis avec getStockCompanyDetail. Posez au plus une question bloquante, et seulement lorsque l'ambiguïté change le type d'actif ou le modèle de surveillance.

Ne résolvez rien en silence : si un symbole ne se résout pas, dites-le à l'utilisateur et continuez avec le reste.

Capturez toute thèse déclarée. Si l'utilisateur dit pourquoi il détient quelque chose ("MSTR comme un jeu BTC à effet de levier", "NVDA pour battre les semi-conducteurs"), analysez-la et stockez-la comme une thèse par action (action · relation · référence · direction) — elle pilote la surveillance liée à la thèse (§Thèse-Liée). Optionnel ; son absence signifie simplement le modèle de marché par défaut.

L'ensemble surveillé est une configuration appartenant à l'utilisateur (ajout/suppression dynamique)

La liste des tickers surveillés n'est pas codée en dur — c'est une configuration que l'utilisateur possède (par exemple ~/feeds/pw-config/v1/holdings.json : [{symbol, name, weight, sector, thesis?}]). Elle peut être initialisée automatiquement à partir du Portfolio Alva connecté (§Étape 1 chemin sans saisie) ou remplie à la main. Les flux la lisent à l'exécution, donc modifier ce qui est surveillé ne nécessite jamais de changement de code :

  • Ajout / suppression à tout moment — deux façons, même configuration. (a) Parlez à l'Agent ("surveille aussi COIN", "arrête de surveiller TSLA") ; il modifie la configuration. (b) Faites-le dans l'interface du Playbook : une UDF enregistrée (updateWatchlist) permet à la boîte de recherche d'ajouter un ticker et à une puce ✕ d'en supprimer un, en écrivant directement dans la configuration (pas de frais ; les visiteurs non authentifiés voient une invite de connexion). Lors de l'ajout, l'UDF calcule l'analyse σ du nouveau ticker sur le champ et le renvoie, afin que l'interface affiche immédiatement le mouvement / z_idio / niveau du nom ajouté ; le profilage complet et les alertes suivent lors de la prochaine exécution planifiée. Vérifié en direct : NVDA/TSLA/AAPL/MSTR → +COIN (preuve calculée en direct, thèse appliquée automatiquement) → −TSLA, par édition de configuration et par UDF.
  • Les nouveaux noms bénéficient automatiquement du traitement complet — un ticker fraîchement ajouté est profilé (sa propre ligne de base σ/β/σ_ε), et s'il est nouvellement coté, il entre dans le chemin de démarrage à froid (§Démarrage à froid). C'est l'exigence de réutilisabilité mise en œuvre : la Compétence fonctionne sur n'importe quel ensemble que l'utilisateur nomme, et l'ensemble est en direct.
  • Les pondérations sont optionnelles (par défaut à pondération égale) ; la thesis par action est optionnelle.

Étape 2 — Flux de Profilage (le moteur de réutilisabilité)

Avant de surveiller quoi que ce soit, construisez un flux qui persiste un profil par action à partir de la configuration ci-dessus, en utilisant l'historique des Skills de données. C'est ce qui rend les seuils relatifs et le routage corrects.

Par action, calculez et stockez :

ChampSource / méthodeUtilisé pour
asset_typedétail de la société / actifquels modèles s'appliquent
sector, industrydétail de la sociétémodèle de secteur + benchmark
sigma_ewma, sigma_mad, sigma_epsvolatilité EWMA(λ=0,94), plancher robuste 1,4826·MAD, et volatilité résiduelle (idiosyncratique) √(σ²−β²σ_m²)dénominateurs de z-score (§Étape 4)
avg_vol_20d, avg_dollar_vol_20d (heure de la journée si intraday)historique de volumeRVOL / rotation / liquidité
free_floatdonnées de propriétédénominateur de rotation
beta, primary_benchmark, sector_benchmark, peer_basketrégression sur benchmarks (voir Annexe A)suppression du bruit marché/secteur
liquidity_bucket, volatility_bucket, market_cap_bucketdérivérigueur de confirmation
options_available, short_interest_available, crypto_exposureindicateurs de capacitéquels confirmateurs s'activent
earnings_next, ex_div_next, event_calendarpoints de terminaison de calendrierplanification d'événements
week52_high, week52_lowklinessignaux de jalons

Actualisez à un rythme lent (quotidien/hebdomadaire). Tous les seuils aval lisent à partir de ce flux — changez le portefeuille et les mêmes règles s'ajustent automatiquement. Pour les noms nouvellement cotés ou peu négociés, exigez des preuves plus solides et marquez la confiance plus basse.

Types d'actifs à reconnaître : action ordinaire, ADR, ETF/ETP, fonds fermé, REIT, BDC, MLP, action privilégiée, SPAC/post-SPAC, actif crypto, action liée aux crypto-monnaies (bourses, mineurs, sociétés de trésorerie, courtiers, proxies stablecoin/paiement — COIN, MSTR, MARA, RIOT, CLSK, HOOD), autre titre coté. Si une action couvre plusieurs modèles, appliquez tous ceux qui sont matériels et marquez le pilote principal.

Étape 3 — Quoi Surveiller (modèle en couches)

Organisez par pourquoi un investisseur s'en soucie, pas par source de données. Les moniteurs universels s'appliquent à chaque action lorsque les données existent ; les modèles ajoutent une intelligence spécifique à l'actif.

Couche A — Prix, performance relative, liquidité (sondage intraday/horaire)

SignalDéfinition (relative)Rôle
Mouvement anormalz = day_return / sigma_20d (aussi 5j/1m/YTD, écart, ouverture-à-fermeture)cœur
Mouvement résiduelrésidu = rendement_ticker − rendement_expliqué_marché_secteur ; signaler lorsque le marché+secteur expliquent moins de la moitié du mouvementcœur
Relatif au secteurz de (rendement_ticker − rendement_benchmark_secteur) ≥ 2,0cœur
Anomalie de volumeRVOL = vol / vol_moyen (ajusté à l'heure de la journée) ; 2× notable, 3× fort, 5×+ catalyseur majeur. 5×+ est souvent culminant/épuisement, pas continuation — à lire avec la direction du prixconfirmateur
Rotationvol / free_float ≥ 2× médiane 60j ou > 90e percentile ; rotation élevée + avance ratée après une bonne nouvelle = distributionconfirmateur
Stress de liquiditéécart bid-ask > 90e percentile pour un nom liquide ; haltes, LULD, SSRconfirmateur
Rupture de fourchetterupture de 20/50/200 jours avec confirmation de volume, ou plus haut/plus bas sur 52 semaines, plus haut historiquefaible
Tendance lenteN jours de baisse consécutifs, ou mouvement cumulé sur 5 jours > 2σ (pas significatif quotidien, significatif cumulativement)lent

Couche B — Événements & Dépôts (piloté par calendrier/dépôt ; beaucoup sont connaissables tôt)

  • Résultats : rappel pré-annonce (T−1/2) + résultat vs estimation + changement de guidance.
  • Dividendes / divisions / spin-offs / ex-div ; changements d'indice ; rééquilibrages d'ETF.
  • Dépôts & propriété : événements matériels 8-K, 10-Q/10-K, langage de continuité d'exploitation, changement d'auditeur/dépôt tardif, restatements, financement/dilution (S-1/S-3/424B/ATM, convertibles, secondaires), transactions d'initiés Formulaire 4, participations activistes 13D. Amélioration achats d'initiés en marché libre, achats groupés de dirigeants, financement pour les noms qui brûlent du cash, 13D activiste. Construit (v1) : une superposition de positionnement smart-money compte les achats/ventes discrétionnaires Formulaire-4 en marché libre (10b5-1 exclu) ; un groupe d'initiés (ou le PDG) achetant est un confirmateur + un avertissement de divergence haussière lorsque le prix est faible — affiché comme contexte de portefeuille, jamais une notification push par action. Dégradation ventes routinières 10b5-1 et ajustements mécaniques de split/dividende.
  • Déblocages / déverrouillages PIPE (SPAC), risque de rachat.
  • Calendrier macro (FOMC, IPC, taux, dollar, pétrole) uniquement lorsque le portefeuille est sensible (bêta élevé ou secteurs exposés aux taux/matières premières) ou que plusieurs actions partagent l'exposition — sinon c'est du bruit pour cet utilisateur.

Couche C — Information & Récit (piloté par les news, pas connaissable à l'avance)

  • Nouvelles matérielles de l'entreprise : fusions-acquisitions, litiges, action réglementaire, changement de direction, échec/rappel de produit majeur (Skills de données news + unified_search pour le contexte).
  • Changements d'estimation et de notation — agrégés, jamais par ligne : une petite révision est du bruit ; un large groupe de révisions dans la même direction, ou un changement d'objectif de cours avec un changement d'estimation/thèse, est un signal.
  • Exigez plusieurs sources crédibles ; supprimez les vieilles nouvelles republiées, les rumeurs à source unique et les commentaires génériques du marché. La vélocité sociale est un signal faible uniquement.
  • Cycle des semi-conducteurs (indice mémoire TrendForce DXI) — construit (v1) comme une superposition de contexte sectoriel : tendance DXI vs ses moyennes mobiles sur 30/60 jours = un vent arrière/vent contraire du cycle mémoire mappé aux actions de semi-conducteurs (le plus direct pour les noms de mémoire ; une lecture large du cycle pour GPU/AI via HBM). Les flux de fonds sectoriels (rotation) et le momentum de révision d'estimation consensuelle sont spécifiés comme confirmateurs conventionnels.
  • Marchés de prédiction (Polymarket) comme signal d'événement structuré — pour les événements avec un marché liquide (décisions de la Fed, élections, certains catalyseurs), un mouvement brusque de la probabilité de l'événement est une réévaluation quantifiée, souvent précoce.

(La suite du document continue avec l'interface, les alertes, et d'autres détails de mise en œuvre.)

Skills associés