Communitygithub.com

george351419-sys/投资组合监控技能

一个可复用的 Alva 投资组合监控技能——将任何投资组合转变为实时仪表盘和安静、排名的警报。关注的是买入逻辑,而不仅仅是市场。基于 Alva 构建,使用 5 年历史数据进行回测,并实时运行。

投资组合监控技能 是什么?

该技能旨在将用户的投资组合(如股票、加密货币等)转变为一个全面的实时监控和警报系统。其核心创新在于“相对阈值”原则:所有异常检测均基于每个持仓的统计基线(如波动率、残差波动率)和行业基准,而非硬编码的百分比变动。这确保了技能能在未见过的投资组合上直接工作,无需针对每个新资产手动调整参数。技能支持 Alva 平台,利用其数据技能、数据源运行时、Altra 计算引擎和推送通知。构建过程遵循一个蓝图:从解析用户意图、自动建立每个资产的统计档案(可复用性引擎)、创建多层监控流(价格、事件、叙事)、生成一个包含四个标签页的 HTML 界面(监控/事件/理论/公式),到配置安静的、可深度链接的推送警报。用户可以通过智能体对话或在界面中动态添加/移除监控资产,新资产会自动获取完整的配置和档案,无需代码修改。此外,该技能能自动拉取用户连接的 Alva 投资组合账户(如经纪账户)作为零输入的起点,并提供基于理论驱动的监控,以更好地识别与用户投资逻辑相关的信号。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add george351419-sys/Portfolio-Watch-Skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

投资组合监控

将诸如 "监控我的 NVDA、TSLA、AAPL,并在发生重大事件时通知我" 这样的一行请求,转变为一个托管的 投资组合监控剧本:一个用户可以打开查看其持仓状况的界面,以及安静、排名的推送警报,这些警报会直接发送到手机并深度链接回对应的卡片。

这是一个方法论蓝图。它不取代 Alva 的构建机制——而是驱动它们。Alva 拥有基础组件(数据技能、运行时数据源、Altra、alpi、剧本发布、推送)。这个技能拥有监控判断:维度、阈值、噪声过滤和排名。当两者在机制上发生冲突时,遵循 alva 技能;在监控什么以及如何报告上,遵循此文件。产品目标是信号,而非覆盖率——将一个从未见过的投资组合中的重大投资信号与市场噪音分离。

核心原则:每个阈值都是相对的

没有硬编码的百分比阈值。 NVDA 下跌 3% 是正常一天;可口可乐下跌 3% 则是新闻。该技能能在未见过的投资组合上工作,因为每个异常测试都是针对该持仓自身的统计基线以及市场及其行业今天表现来衡量的,这在设置时计算完成。这是整个可复用性引擎——如果这部分正确,其余部分自然顺利进行。

构建顺序(映射到 Alva 基础组件)

遵循 alva 技能的会话启动和门控。本技能特定的顺序是:

  1. 接收 — 解析持仓、权重、意图、警报渠道、时间范围。
  2. 档案数据源 — 每个持仓的基线 + 基准路由(可复用性引擎)。首先构建它;所有阈值都从中读取。
  3. 监控数据源 — 监控层,发出评分后的信号。
  4. 剧本界面 — 实时读取 HTML,四个标签页(监控 / 事件 / 理论 / 公式 — 参见 §界面);理论和公式标签页是必需的,而非可选的。
  5. 警报附加工件 — notify/message 推送,默认安静且深度链接。
  6. 发布和验证 — 发布、截图、启用警报、确认一次真实运行。

对每个数字使用 Alva 数据技能,使用 @alva/feed 进行持久化,使用 FeedAltra 进行投资组合级别的数学运算(权重、回撤、相关性、贡献),使用 @alva/pi 进行一行式叙述,并遵循 references/push-notifications.md 中的推送流程。切勿将金融价值硬编码到 HTML 中。


第 0 步 — 入门与预检查(首先运行此步,从一行请求开始)

用户通常会在全新的本地智能体中调用此技能,并且只说一句话——"监控我的 NVDA、TSLA、AAPL,有大的波动时通知我。" 根据这句话,主动驱动整个设置和构建过程——不要让他们手动配置,也不要询问你可以默认设定的规格。在构建之前,静默检查三个先决条件,并且只有在缺少某些内容时才引导用户:

  1. 基础 Alva 技能可用? 此技能声明了 builds_on: alva 并且需要 Alva 的平台基础组件(数据源、剧本发布、推送)。如果智能体无法访问 Alva 构建工具,请告知用户安装一次,然后重试: npx skills add https://github.com/alva-ai/skills。
  2. 已登录 Alva? 剧本是在用户自己的账户下创建的,警报也是发送给他们的,因此他们必须经过身份验证(使用 alva whoami 检查;如果未登录,使用 alva auth login)。如果需要,引导一次性登录。
  3. 已连接警报渠道? 要使推送信息到达手机,用户需要在 alva.ai/settings 链接一个 active_channel(Discord / Telegram / Slack)。使用 alva whoami 检查(active_channel);如果没有,现在记下来,但不要阻塞构建——在第一个警报准备好之后再次提醒。

然后就直接构建它:解析那行文本(第 1 步),建立档案 + 监控数据源和界面,并将警报连接到用户(参见警报 → 交付给此用户)。用一行报告回来:"正在监控 NVDA/TSLA/AAPL · 界面: <链接> · 警报 → 你的 <渠道>。" 最多提出一个阻塞性问题,并且仅当确实存在歧义时。默认所有其他内容(等权重、标准灵敏度、长期限)。

第 1 步 — 接收(适用于未见过的投资组合)

提取:股票代码/资产、股份或名义价值、权重、成本基础、监控风格、警报渠道、时区、时间范围。

首选零输入路径——拉取用户真实投资组合。 Alva 有一个原生投资组合模块(通过 TREX + SnapTrade 连接的券商/加密货币账户)。如果用户说 "监控我的投资组合" 并且有已链接的账户,不要让他们手动输入股票代码——直接读取持仓并填充监控集合:

  1. alva portfolio accounts → 列出已连接的账户(trex:… / snaptrade:…)。如果有多个,询问哪一个(或者监控所有,取并集)。
  2. alva portfolio summary --account-id <id> → 持仓 + 余额。将每个持仓映射到 {symbol, name, weight (from market value / total), sector} 并将其写入监控集合配置(下文)。权重自动从真实余额得出,因此排名是精确的,而不是等权重的。
  3. 在监控之前,用一行向用户确认已解析的列表;然后数据源会自动为每个名称建立档案(§第 2 步),理论提示也会随之进行。
  4. 按需同步——"同步我的投资组合"将重新读取账户并与配置进行差异对比(新买入已添加,完全退出已移除);alva portfolio activities 提供最近的交易记录。这在智能体以用户自身身份运行时进行——无头数据源无法冒充用户,因此刷新是由用户触发的(或通过存储的受限令牌),永远不是静默的后台拉取。如果没有链接账户,则回退到下面手动接收。

缺失时的默认值:

  • 权重 — 等权重;将投资组合影响估计标记为近似值。权重仅影响排名,不影响是否检测到异常。
  • 监控风格 — 标准(P0 即时、P1 消化后、P2 界面仅显示)。
  • 时间范围 — 长期;相对于小的技术性波动,更强调基本面、事件、流动性、申报文件和投资组合影响。
  • 模糊股票代码 — 使用 getStockCompanyDetail 将其解析为最可能的美国上市证券。最多提出一个阻塞性问题,并且仅当歧义改变了资产类型或监控模板时。

不要静默地解析:如果一个符号无法解析,告知用户并继续处理其余部分。

捕获任何陈述的理论。 如果用户说明为什么他们持有某物("MSTR 作为杠杆比特币操作"、"NVDA 超越半导体"),则解析并存储为每个持仓的理论(持仓 · 关系 · 参考 · 方向)——它驱动理论链接的监控(§理论链接)。可选;缺失仅意味着使用默认市场模型。

监控集合是用户拥有的配置(动态添加/移除)

被监控的股票代码列表是非硬编码的——它是一个用户拥有的配置(例如 ~/feeds/pw-config/v1/holdings.json: [{symbol, name, weight, sector, thesis?}])。它可以从已连接的 Alva 投资组合自动填充(§第 1 步零输入路径)或手动填写。数据源在运行时读取它,因此更改监控内容永远不需要代码更改:

  • 随时添加/移除 — 两种方式,同一配置。 (a) 与智能体对话("也监控 COIN"、"停止监控 TSLA");它编辑配置。(b) 在剧本 UI 中操作:一个已注册的 UDF(updateWatchlist) 允许搜索框添加一个股票代码,并且标签页上的 ✕ 图标移除一个,直接写入配置(免费;未认证的查看者会看到登录提示)。添加时,UDF 立即计算新股票代码的 σ 分析并返回,因此界面会立即显示添加名称的变动/z_idio/等级;完整配置文件和警报将在下一次计划运行时跟随。已验证实时可用:NVDA/TSLA/AAPL/MSTR → +COIN(证据实时计算,理论自动应用)→ −TSLA,通过配置编辑和 UDF 操作。
  • 新名称会自动获得完整处理 — 一个新添加的股票代码会被建立档案(其自身的 σ/β/σ_ε 基线),如果是新上市的,它将进入冷启动路径(§冷启动)。这使可复用性要求得以操作化:该技能适用于用户指定的任何集合,并且该集合是实时的。
  • 权重是可选的(默认为等权重);每个持仓的 thesis 是可选的。

第 2 步 — 档案数据源(可复用性引擎)

在监控任何内容之前,建立一个数据源,使用数据技能的历史数据,为上述配置中的每个持仓持久化一个档案。这就是使阈值相对和路由正确的关键。

对于每个持仓,计算并存储:

字段来源/方法用于
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(如果是盘中则为日内时间点)成交量历史相对成交量 / 换手率 / 流动性
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_lowK 线里程碑信号

以较慢的节奏(每日/每周)刷新。所有下游阈值都从此数据源读取——更改投资组合,相同的规则会自动重新拟合。对于新上市或交易清淡的名称,需要更强的证据并将置信度标记为较低。

要识别的资产类型: 普通股、ADR、ETF/ETP、封闭式基金、REIT、BDC、MLP、优先股、SPAC/去 SPAC、加密资产、加密相关股票(交易所、矿商、国债公司、经纪商、稳定币/支付代理——COIN、MSTR、MARA、RIOT、CLSK、HOOD)、其他上市证券。如果一个持仓跨越多个模板,应用所有重要的模板并标记主要驱动因素。

第 3 步 — 监控什么(分层模型)

按投资者为何关心来组织,而非按数据源。通用监控器在数据存在时适用于每个持仓;模板添加特定于资产的情报。

层 A — 价格、相对表现、流动性(盘中/每小时轮询)

信号定义(相对)角色
异常波动z = 日收益率 / sigma_20d(同时也考虑5天/1月/年初至今、跳空、开盘至收盘)核心
残差波动残差 = 股票收益率 − 已解释的市场/行业波动;当市场+行业能解释不到一半的波动时触发标记核心
相对于行业(股票收益率 − 行业基准收益率) 的 z ≥ 2.0核心
成交量异常相对成交量 = 成交量 / 平均成交量(日内时间点调整);2 倍值得关注,3 倍强烈,5 倍以上为主要催化剂。5 倍以上通常表明高潮/衰竭,而非持续——结合价格方向解读确认器
换手率成交量 / 自由流通股 ≥ 2 倍 60 天中位数 或 > 90 百分位;高换手率 + 利好新闻后未能上涨 = 派发确认器
流动性压力对于流动性强的名称,买卖价差 > 90 百分位;停牌、LULD、SSR确认器
区间突破20/50/200 日均线突破伴有成交量确认,或 52 周新高/新低、历史新高弱势
缓慢趋势连续 N 个下跌日,或 5 天累计波动 > 2σ(非每日显著,但累计显著)缓慢

层 B — 事件与申报(基于日历/申报;许多可提前知晓)

  • 财报:预先提醒 (T−1/2) + 结果与预期对比 + 指引变化。
  • 股息/拆股/分拆/除权除息;指数变动;ETF 再平衡。
  • 申报与所有权: 8-K 重大事件、10-Q/10-K、持续经营问题、审计师变更/迟报、重述、融资/稀释(S-1/S-3/424B/ATM、可转债、增发)、表格 4 内幕交易、13D 激进投资者持股。升级公开市场内幕买入、高管集中买入、现金消耗型公司的融资、激进 13D。已构建 (v1): 一个 Smart-money 持仓 覆盖层计数可自由决定的公开市场 Form-4 买入/卖出(排除 10b5-1);一群内幕人士(或 CEO)买入是一个确认器 + 当价格疲软时看涨背离的提醒——作为投资组合上下文显示,从不作为单只股票的推送。降级常规 10b5-1 销售和机械的拆股/股息调整。
  • 锁定期 / PIPE 解锁(SPAC),赎回风险。
  • 宏观日历(FOMC、CPI、利率、美元、石油)仅当投资组合敏感时(高 beta 或利率/大宗商品敏感行业)或几个持仓共有该敞口——否则对用户来说是噪音。

层 C — 信息与叙事(新闻驱动,无法提前知晓)

  • 重大公司新闻:并购、诉讼、监管行动、高管变更、重大产品失败/召回(数据技能新闻 + unified_search 用于上下文)。
  • 预估与评级变化——汇总,绝不逐行处理:一个小的修订是噪音;同方向上的一系列修订,或伴随预估/理论变化的目标变更,是一个信号。
  • 要求多个可信来源;压制重复发布的旧新闻、单一来源的传闻和泛泛的市场评论。社交热度仅是弱势信号。
  • 半导体周期 (TrendForce DXI 内存指数) — 已构建 (v1) 作为 行业背景 覆盖层:DXI 趋势与其 30/60 日均线的关系 = 映射到半导体持仓的内存周期顺风/逆风(对于内存名称最直接;对于通过 HBM 的 GPU/AI 则是广泛的周期解读)。行业资金流向(板块轮动)和共识预估修正动能被作为传统确认器。
  • 预测市场 (Polymarket) 作为结构化事件信号 — 对于具有流动性市场的重大事件(美联储决策、选举、一些催化剂),事件概率的剧烈变动是一个量化的、通常是早期的重新定价。

相关技能