Alerta de Portafolio
Convierte una solicitud de una sola línea como "vigila mi NVDA, TSLA, AAPL y avísame cuando algo grande suceda" en un Playbook de Alerta de Portafolio alojado: una interfaz que el usuario abre para ver qué está sucediendo con sus tenencias, más alertas push silenciosas y clasificadas que llegan a su teléfono y tienen un enlace profundo de regreso a la tarjeta correspondiente.
Este skill es un modelo de metodología. No reemplaza los mecanismos de construcción de Alva, los impulsa. Alva posee las primitivas (Habilidades de Datos, fuentes en tiempo de ejecución, Altra, Alpi, lanzamiento de Playbooks, push). Este skill posee el criterio de monitoreo: dimensiones, umbrales, filtros de ruido y clasificación. Cuando ambos entren en conflicto sobre mecánica, sigue el skill alva; sobre qué vigilar y qué decir, sigue este archivo. El objetivo del producto es la señal, no la cobertura: separar las señales de inversión materiales del ruido del mercado para un portafolio que nunca ha visto.
Principio Central: Cada Umbral es Relativo
No hay umbrales porcentuales fijos. NVDA cayendo un 3% es un día normal; Coca-Cola cayendo un 3% es noticia. El skill funciona en un portafolio desconocido porque cada prueba de anomalía se mide en función de la propia línea base estadística de esa tenencia y en función de lo que el mercado y su sector hicieron hoy, calculado en la configuración. Este es el motor de reutilización completo: hazlo bien y el resto sigue.
Orden de Construcción (mapear a primitivas de Alva)
Sigue el inicio de sesión y las puertas del skill alva. El orden específico del skill es:
- Ingesta — analizar tenencias, ponderaciones, intención, canal de alerta, horizonte temporal.
- Fuente de perfil — línea base por tenencia + enrutamiento de referencia (el motor de reutilización). Constrúyelo primero; todos los umbrales leen de él.
- Fuente(s) de seguimiento — las capas de monitoreo, emitiendo señales puntuadas.
- Interfaz del Playbook — HTML de lectura en vivo, cuatro pestañas (Ver / Incidente / Teoría / Fórmulas — ver §La Interfaz); Teoría y Fórmulas son obligatorias, no opcionales.
- Componente lateral de alerta —
notify/messagepush, silencioso por defecto, con enlace profundo. - Lanzamiento + verificar — lanzar, capturar pantalla, habilitar alerta, confirmar una ejecución real.
Usa las Habilidades de Datos de Alva para cada número, @alva/feed para persistencia, FeedAltra para matemáticas a nivel de portafolio (ponderaciones, drawdown, correlación, contribución), @alva/pi para narrativa de una línea y el flujo push de references/push-notifications.md. Nunca codifiques valores financieros en el HTML.
Paso 0 — Incorporación y Verificación Previa (ejecutar esto primero, desde una línea)
A menudo, un usuario invoca este skill desde un agente local nuevo sin nada configurado y dice una línea — "vigila mi NVDA, TSLA, AAPL y avísame en movimientos grandes." A partir de esa línea, impulsa de forma proactiva toda la configuración y construcción — no hagas que configuren cosas manualmente y no pidas especificaciones que puedas predeterminar. Antes de construir, verifica silenciosamente tres requisitos previos y guía al usuario solo donde falte algo:
- ¿Skill base de Alva disponible? Este skill declara
builds_on: alvay necesita las primitivas de la plataforma Alva (fuentes, lanzamiento de Playbook, push). Si el agente no puede alcanzar las herramientas de construcción de Alva, dile al usuario que las instale una vez y luego reintente:npx skills add https://github.com/alva-ai/skills. - ¿Ha iniciado sesión en Alva? El Playbook se crea bajo la propia cuenta del usuario y las alertas se entregan a ellos, por lo que deben estar autenticados (
alva whoamipara verificar;alva auth loginsi no). Guía el inicio de sesión único si es necesario. - ¿Canal de alerta conectado? Para que los push lleguen al teléfono, el usuario necesita un
active_channel(Discord / Telegram / Slack) vinculado en alva.ai/settings. Verificaalva whoami(active_channel); si no hay ninguno, anótalo ahora pero no bloquees la construcción — recuérdalo de nuevo justo después de que la primera alerta esté lista.
Luego solo constrúyelo: analiza la línea (Paso 1), levanta las fuentes de perfil + seguimiento y la interfaz, y conecta las alertas al usuario (ver Las Alertas → Entregar a este usuario). Informa en una línea: "Vigilando NVDA/TSLA/AAPL · interfaz: <link> · alertas → tu <channel>." Pregunta como máximo una pregunta bloqueante, y solo si es realmente ambiguo. Predetermina todo lo demás (peso igual, sensibilidad Estándar, horizonte a largo plazo).
Paso 1 — Ingesta (funciona en un portafolio desconocido)
Extraer: tickers/activos, acciones o nocional, ponderaciones, base de costo, estilo de vigilancia, canal de alerta, zona horaria, horizonte temporal.
Ruta de entrada cero preferida: extraer el portafolio real del usuario. Alva tiene un módulo de Portafolio nativo (cuentas de corretaje/cripto conectadas a través de TREX + SnapTrade). Si el usuario dice "vigila mi portafolio" y tiene una cuenta vinculada, no le pidas que escriba tickers — lee las posiciones directamente y completa el conjunto vigilado:
alva portfolio accounts→ lista de cuentas conectadas (trex:…/snaptrade:…). Si hay varias, pregunta cuál (o vigila todas, unidas).alva portfolio summary --account-id <id>→ tenencias + saldo. Mapea cada posición a{symbol, name, weight (from market value / total), sector}y escríbela en la configuración del conjunto vigilado (abajo). Las ponderaciones vienen gratis de los saldos reales, por lo que la clasificación es exacta en lugar de igual ponderación.- Confirma la lista resuelta al usuario en una línea antes de monitorear; luego la fuente se perfiliza automáticamente cada nombre (§Paso 2) y siguen las indicaciones de tesis.
- Sincronizar a petición — "sincroniza mi portafolio" re-lee las cuentas y hace un diff con la configuración (nuevas compras agregadas, salidas completas eliminadas);
alva portfolio activitiesproporciona el rastro de operaciones recientes. Esto se ejecuta en el Agente bajo la propia identidad del usuario — una fuente sin cabeza no puede hacerse pasar por el usuario, por lo que la actualización es activada por el usuario (o mediante un token restringido almacenado), nunca una extracción silenciosa en segundo plano. Si no hay ninguna cuenta vinculada, recurre a la ingesta manual a continuación.
Valores predeterminados cuando falta:
- Ponderaciones — peso igual; etiqueta las estimaciones de impacto del portafolio como aproximadas. Las ponderaciones afectan solo la clasificación, nunca si se detecta una anomalía.
- Estilo de vigilancia — Estándar (P0 inmediato, P1 digerido, P2 solo interfaz).
- Horizonte temporal — a largo plazo; enfatizar fundamentos, eventos, liquidez, presentaciones e impacto en el portafolio sobre movimientos técnicos pequeños.
- Ticker ambiguo — resolver al valor cotizado en EE. UU. más probable con
getStockCompanyDetail. Pregunta como máximo una pregunta bloqueante, y solo cuando la ambigüedad cambie el tipo de activo o la plantilla de monitoreo.
No resuelvas nada en silencio: si un símbolo no se resuelve, informa al usuario y continúa con el resto.
Captura cualquier tesis declarada. Si el usuario dice por qué posee algo ("MSTR como una jugada apalancada de BTC", "NVDA para vencer a los semis"), analízalo y almacénalo como una tesis por tenencia (tenencia · relación · referencia · dirección) — impulsa el monitoreo vinculado a la tesis (§Vinculado a Tesis). Opcional; la ausencia solo significa el modelo de mercado predeterminado.
El conjunto vigilado es una configuración propiedad del usuario (agregar/eliminar dinámicamente)
La lista de tickers monitoreados no está codificada — es una configuración que el usuario posee (por ejemplo, ~/feeds/pw-config/v1/holdings.json: [{symbol, name, weight, sector, thesis?}]). Puede inicializarse automáticamente desde el Portafolio de Alva conectado (§Paso 1 ruta de entrada cero) o completarse manualmente. Las fuentes lo leen en tiempo de ejecución, por lo que cambiar lo que se vigila nunca necesita un cambio de código:
- Agregar / eliminar en cualquier momento — dos formas, misma configuración. (a) Habla con el Agente ("también vigila COIN", "deja de vigilar TSLA"); edita la configuración. (b) Hazlo en la UI del Playbook: un UDF (
updateWatchlist) registrado permite que el cuadro de búsqueda agregue un ticker y que una ✕ de chip lo elimine, escribiendo directamente en la configuración (sin costo; los espectadores no autenticados ven un mensaje de inicio de sesión). Al agregar, el UDF calcula el análisis σ del nuevo ticker en el acto y lo devuelve, por lo que la interfaz muestra el movimiento/z_idio/nivel del nombre agregado inmediatamente; el perfilado completo y las alertas siguen en la próxima ejecución programada. Verificado en vivo: NVDA/TSLA/AAPL/MSTR → +COIN (evidencia calculada en vivo, tesis aplicada automáticamente) → −TSLA, por edición de configuración y por UDF. - Los nuevos nombres reciben el tratamiento completo automáticamente — un ticker recién agregado se perfila (su propia línea base σ/β/σ_ε), y si es de nueva cotización entra en la ruta de inicio en frío (§Inicio en Frío). Este es el requisito de reutilibilidad hecho operativo: el Skill funciona en cualquier conjunto que el usuario nombre, y el conjunto está vivo.
- Las ponderaciones son opcionales (peso igual predeterminado); la
thesispor tenencia es opcional.
Paso 2 — Fuente de Perfil (el motor de reutilización)
Antes de vigilar cualquier cosa, construye una fuente que persista un perfil por tenencia de la configuración anterior, utilizando el historial de Habilidades de Datos. Esto es lo que hace que los umbrales sean relativos y el enrutamiento correcto.
Por tenencia, calcula y almacena:
| Campo | Fuente/Método | Se usa para |
|---|---|---|
asset_type | detalle de empresa/activo | qué plantillas aplican |
sector, industry | detalle de empresa | plantilla de sector + referencia |
sigma_ewma, sigma_mad, sigma_eps | volatilidad EWMA(λ=0.94), piso robusto 1.4826·MAD y volatilidad residual (idiosincrásica) √(σ²−β²σ_m²) | denominadores de puntuación z (§Paso 4) |
avg_vol_20d, avg_dollar_vol_20d (hora del día si intradía) | historial de volumen | RVOL / rotación / liquidez |
free_float | datos de propiedad | denominador de rotación |
beta, primary_benchmark, sector_benchmark, peer_basket | regresión en puntos de referencia (ver Apéndice A) | eliminación de ruido de mercado/sector |
liquidity_bucket, volatility_bucket, market_cap_bucket | derivado | rigor de confirmación |
options_available, short_interest_available, crypto_exposure | banderas de capacidad | qué confirmadores se activan |
earnings_next, ex_div_next, event_calendar | endpoints de calendario | programación de eventos |
week52_high, week52_low | klines | señales de hitos |
Actualizar en una cadencia lenta (diaria/semanal). Todos los umbrales posteriores leen de esta fuente — cambia el portafolio y las mismas reglas se reajustan automáticamente. Para nombres de nueva cotización o poco negociados, requiere evidencia más sólida y marca la confianza como más baja.
Tipos de activos a reconocer: renta variable común, ADR, ETF/ETP, fondo cerrado, REIT, BDC, MLP, preferente, SPAC/post-SPAC, activo cripto, renta variable vinculada a cripto (exchanges, mineros, empresas de tesorería, corredores, proxies de stablecoin/pago — COIN, MSTR, MARA, RIOT, CLSK, HOOD), otros valores cotizados. Si una tenencia abarca plantillas, aplica todas las materiales y marca el impulsor principal.
Paso 3 — Qué Vigilar (modelo en capas)
Organizar por por qué a un inversor le importa, no por fuente de datos. Los monitores universales se aplican a cada tenencia cuando existen datos; las plantillas agregan inteligencia específica del activo.
Capa A — Precio, rendimiento relativo, liquidez (sondear intradía/cada hora)
| Señal | Definición (relativa) | Rol |
|---|---|---|
| Movimiento anormal | z = day_return / sigma_20d (también 5d/1m/YTD, brecha, apertura a cierre) | núcleo |
| Movimiento residual | residual = ticker_return − explained_market_sector_move; marcar cuando mercado+sector explican menos de la mitad del movimiento | núcleo |
| Relativo al sector | z de (ticker_return − sector_benchmark_return) ≥ 2.0 | núcleo |
| Anomalía de volumen | RVOL = vol / avg_vol (ajustado por hora del día); 2× notable, 3× fuerte, 5×+ catalizador mayor. 5×+ suele ser climático/agotamiento, no continuación — leer con la dirección del precio | confirmador |
| Rotación | vol / free_float ≥ 2× mediana de 60d o > percentil 90; alta rotación + avance fallido después de buenas noticias = distribución | confirmador |
| Estrés de liquidez | diferencial oferta-demanda > percentil 90 para un nombre líquido; paradas, LULD, SSR | confirmador |
| Ruptura de rango | ruptura de media móvil de 20/50/200 días con confirmación de volumen, o máximo/mínimo de 52 semanas, máximo histórico | débil |
| Tendencia lenta | N días consecutivos a la baja, o movimiento acumulado de 5 días > 2σ (no significativo diariamente, significativo acumulativamente) | lenta |
Capa B — Eventos y presentaciones (impulsado por calendario/presentaciones; muchos son conocibles con anticipación)
- Ganancias: recordatorio previo al anuncio (T−1/2) + resultado vs estimación + cambio de guía.
- Dividendos / splits / escisiones / ex-dividendo; cambios de índice; reequilibrio de ETF.
- Presentaciones y propiedad: eventos materiales 8-K, 10-Q/10-K, lenguaje de empresa en funcionamiento, cambio de auditor/presentación tardía, reexpresiones, financiamiento/dilución (S-1/S-3/424B/ATM, convertibles, secundarias), transacciones de personas con información privilegiada Formulario 4, participaciones activistas 13D. Mejorar compras de personas con información privilegiada en mercado abierto, compras ejecutivas agrupadas, financiamiento para nombres que queman efectivo, 13D activista. Construido (v1): una superposición de Posicionamiento de dinero inteligente cuenta las compras/ventas discrecionales del Formulario-4 en mercado abierto (se excluye 10b5-1); un grupo de personas con información privilegiada (o el CEO) comprando es un confirmador + un aviso de divergencia alcista cuando el precio es débil — se muestra como contexto del portafolio, nunca un push por acción. Degradar ventas rutinarias de 10b5-1 y ajustes mecánicos de split/dividendo.
- Desbloqueos de lockup/PIPE (SPACs), riesgo de reembolso.
- Calendario macro (FOMC, IPC, tasas, dólar, petróleo) solo cuando el portafolio es sensible (alto beta o sectores expuestos a tasas/materias primas) o varias tenencias comparten la exposición — de lo contrario, es ruido para este usuario.
Capa C — Información y narrativa (impulsado por noticias, no conocible con anticipación)
- Noticias materiales de la empresa: fusiones y adquisiciones, litigios, acciones regulatorias, cambio ejecutivo, fallo/retirada importante de producto (Habilidades de Datos noticias +
unified_searchpara contexto). - Cambios de estimación y calificación — agregados, nunca por línea: una revisión pequeña es ruido; un grupo amplio de revisiones en la misma dirección, o un cambio de objetivo con un cambio de estimación/tesis, es una señal.
- Requerir múltiples fuentes creíbles; suprimir noticias viejas republicadas, rumores de una sola fuente y comentarios genéricos del mercado. La velocidad social es solo una señal débil.
- Ciclo de semiconductores (índice de memoria TrendForce DXI) — construido (v1) como una superposición de contexto sectorial: tendencia DXI vs sus MM de 30/60 días = un viento de cola/contra de ciclo de memoria mapeado a tenencias de semiconductores (más directo para nombres de memoria; una lectura de ciclo amplia para GPU/IA a través de HBM). Los flujos de fondos sectoriales (rotación) y el impulso de revisión de estimaciones de consenso están especificados como confirmadores convencionales.
- Mercados de predicción (Polymarket) como una señal de evento estructurada — para eventos con un mercado líquido (decisiones de la Fed, elecciones, algunos catalizadores), un movimiento brusco en la probabilidad del evento es una revalorización cuantificada y a menudo temprana. U
…
[truncado para traducción]