Communitygithub.com

george351419-sys/Portfolio-Watch-Skill

一個可重複使用的投資組合監控技能,專為 Alva 設計——將任何投資組合轉變為即時儀表板與安靜、分級警報。監控買入論點,而不只是市場波動。基於 Alva 建置,並以 5 年歷史資料進行回測。

Portfolio-Watch-Skill 是什麼?

此技能(Portfolio Watch)旨在將使用者的一句簡單指令(例如「監控我的 NVDA、TSLA、AAPL,並在發生重大事件時通知我」)轉化為一個完整的投資組合監控Playbook。它提供一個即時HTML介面,讓使用者能透過四個標籤(Watch / Incident / Theory / Formulas)查看持股狀況,並透過手機推送安靜、分級的警報,且警報會深層連結回對應的卡片。核心原則是「每個門檻都是相對的」:所有異常測試均基於該持股本身的統計基準(如EWMA波動度、殘差波動度)以及市場與其板塊當日的表現來計算,而非使用硬編碼的百分比,這使其能適用於任何未見過的投資組合。此技能與 Alva 平台緊密整合,利用其 Data Skills、@alva/feed、FeedAltra 等基礎元件來擷取資料、持續化資料與執行組合層級數學運算,並處理Playbook發布與推播通知。使用者可以透過與Agent對話或在Playbook UI中使用UDF(updateWatchlist)動態新增或移除監控標的,所有變更會即時生效。技能支援從使用者已連結的Alva Portfolio模組(支援TREX與SnapTrade)自動匯入真實持股,無需手動輸入。監控層分為價格與流動性(A層)、事件與申報文件(B層)以及資訊與敘事(C層),並包含針對特定資產類型(如普通股、ETF、加密貨幣相關股票)的模板。此技能本質上是一個方法論藍圖,專注於監控判斷(維度、門檻、噪音過濾與排名),而Alva負責執行機制。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Portfolio Watch

將像 「監控我的 NVDA、TSLA、AAPL,並在發生重大事件時通知我」 這樣的一行請求,轉化為一個託管的 Portfolio Watch Playbook:一個使用者可以開啟的介面,用來查看其持股的狀況,以及安靜、分級的推播警報,這些警報會送達他們的手機並深層連結回對應的卡片。

此技能是一個方法論藍圖。它不會取代 Alva 的建構機制——而是驅動它們。Alva 擁有基礎元件(Data Skills、執行時期饋送、Altra、alpi、Playbook發布、推播)。此技能擁有監控判斷:維度、門檻、噪音過濾器和排名。當兩者在機制上衝突時,遵循 alva 技能;在監控什麼以及要說什麼上衝突時,遵循此文件。產品目標是訊號,而非覆蓋率——為一個從未見過的投資組合,將重大的投資訊號與市場噪音區分開來。

核心原則:每個門檻都是相對的

沒有硬編碼的百分比門檻。 NVDA 下跌 3% 是正常的一天;可口可樂下跌 3% 就是新聞。此技能能應用於未見過的投資組合,是因為每一項異常測試都是相對於該持股自身的統計基準,以及市場及其板塊今日的表現來衡量,並在設定時計算。這就是整個可重用性的引擎——把它做對,其他部分就水到渠成。

建構順序(映射到 Alva 基礎元件)

遵循 alva 技能的會話啟動和門檻。技能特定的順序如下:

  1. 接收 — 解析持股、權重、意圖、警報頻道、時間範圍。
  2. 設定檔饋送 — 每個持股的基準線 + 基準路由(可重用性引擎)。優先建構它;所有門檻都從此讀取。
  3. 監控饋送 — 監控層,發出帶有評分的訊號。
  4. Playbook 介面 — 即時讀取的 HTML,四個標籤(Watch / Incident / Theory / Formulas — 參見 §介面);Theory 和 Formulas 是必需的,非選用。
  5. 警報附屬程式 — notify/message 推播,預設為安靜,深層連結。
  6. 發布並驗證 — 發布、截圖、啟用警報、確認一次實際運行。

對每個數字使用 Alva Data Skills,使用 @alva/feed 進行持續化,使用 FeedAltra 進行投資組合層級的數學運算(權重、回撤、相關性、貢獻),使用 @alva/pi 進行一行敘述,以及使用 references/push-notifications.md 中的推播流程。切勿將財務值硬編碼到 HTML 中。


步驟 0 — 入門與預檢查(優先執行此步驟,從一行指令開始)

使用者經常從一個全新的本地代理,沒有任何設定,然後只說一句話來呼叫此技能——「監控我的 NVDA、TSLA、AAPL,並在出現大波動時通知我。」 從那句話開始,主動驅動整個設定和建構流程——不要讓他們手動設定,也不要詢問你可以預設的規格。在建構之前,靜默檢查三個先決條件,並只在缺少某些項目時引導使用者:

  1. 基礎 Alva 技能可用? 此技能宣告 builds_on: alva 且需要 Alva 的平台基礎元件(饋送、Playbook發布、推播)。如果代理無法訪問 Alva 建構工具,請告知使用者安裝一次,然後重試: npx skills add https://github.com/alva-ai/skills。
  2. 已登入 Alva? Playbook 是在使用者自己的帳戶下創建的,並且警報會傳送給他們,因此他們必須經過身分驗證(使用 alva whoami 檢查;如果未登入則使用 alva auth login)。如有需要,引導進行一次性登入。
  3. 警報頻道已連接? 為了讓推播訊息送達手機,使用者需要在 alva.ai/settings 連結一個 active_channel(Discord / Telegram / Slack)。使用 alva whoami 檢查(active_channel);如果沒有,現在先記下來,但不要阻止建構流程——在第一個警報準備好後再次提醒。

然後直接建構它:解析該行指令(步驟 1),建立設定檔 + 監控饋送和介面,並將警報連接到使用者(參見警報 → 傳送給此使用者)。用一行回報:「正在監控 NVDA/TSLA/AAPL · 介面:<連結> · 警報 → 你的 <頻道>。」 最多提出一個阻礙性的問題,並且只有在真正不明確時才提問。其他所有選項都使用預設值(等權重、標準敏感度、長期投資展望)。

步驟 1 — 接收(適用於未見過的投資組合)

提取:股票代碼/資產、股數或名目價值、權重、成本基礎、監控風格、警報頻道、時區、時間範圍。

偏好的零輸入路徑——提取使用者真實的投資組合。 Alva 有一個原生的 Portfolio 模組(透過 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 作為一個槓桿化的 BTC 投資」、「NVDA 擊敗半導體股」),請將其解析並儲存為每個持股的論點(holding · relation · reference · direction)——它會驅動與論點連結的監控(§論點連結)。可選;缺席僅表示使用預設的市場模型。

監控清單是使用者擁有的設定(動態增減)

被監控的股票代碼列表不是硬編碼的——它是一個使用者擁有的設定(例如 ~/feeds/pw-config/v1/holdings.json:[{symbol, name, weight, sector, thesis?}])。它可以從已連接的 Alva Portfolio 自動匯入(§步驟 1 零輸入路徑)或手動填寫。饋送在執行時期讀取它,因此更改監控項目永遠不需要更改程式碼:

  • 隨時增減——兩種方式,同一個設定。 (a) 與 Agent 對話(「也監控 COIN」、「停止監控 TSLA」);它會編輯設定。 (b) 在 Playbook UI 中執行:一個註冊的 UDF(updateWatchlist) 讓搜尋框可以新增股票代碼,晶片上的 ✕ 可以移除一個,直接寫入設定(無需收費;未經身份驗證的檢視者會看到登入提示)。新增時,UDF 會即時計算新股票代碼的 σ 分析並返回,因此介面會立即顯示新增名稱的波動/z_idio/層級;完整的設定檔分析和警報將在下次排程執行時跟進。已驗證即時運作:NVDA/TSLA/AAPL/MSTR → +COIN(證據即時計算,論點自動套用)→ −TSLA,透過設定編輯和 UDF 完成。
  • 新名稱會自動獲得完整處理——一個新加入的股票代碼會被分析(其自身的 σ/β/σ_ε 基準),如果是新上市,則會進入冷啟動路徑(§冷啟動)。這使得可重用性要求得以運作:此技能適用於使用者命名的任何組合,並且該組合是即時的。
  • 權重是可選的(預設為等權重);每個持股的 thesis 是可選的。

步驟 2 — 設定檔饋送(可重用性引擎)

在監控任何項目之前,建立一個饋送,使用 Data Skills 的歷史記錄為上述設定中的每個持股持續儲存一個設定檔。這就是使門檻相對且路由正確的關鍵。

對每個持股,計算並儲存:

欄位來源/方法用於
asset_type公司/資產詳細資料決定應用哪些模板
sector, industry公司詳細資料板塊模板 + 基準
sigma_ewma, sigma_mad, sigma_epsEWMA(λ=0.94) 波動度、1.4826·MAD 穩健下限、以及殘差(特質)波動度 √(σ²−β²σ_m²)z-score 分母(§步驟 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_lowK線資料里程碑訊號

以較慢的節奏(每日/每週)重新整理。所有下游門檻都從此饋送讀取——更改投資組合,相同的規則會自動重新套用。對於新上市或交易清淡的名稱,需要更強的證據並將信心標記為較低。

要辨識的資產類型: 普通股、ADR、ETF/ETP、封閉式基金、REIT、BDC、MLP、優先股、SPAC/後SPAC、加密貨幣資產、加密貨幣相關股票(交易所、礦商、國庫公司、經紀商、穩定幣/支付代理——COIN、MSTR、MARA、RIOT、CLSK、HOOD)、其他上市證券。如果一個持股跨越模板,請套用所有重要的模板並標記主要驅動因素。

步驟 3 — 監控什麼(分層模型)

根據投資者關心的原因來組織,而非資料來源。通用監控器適用於所有持股(當資料存在時);模板則增加資產特定的智慧。

層 A — 價格、相對表現、流動性(盤中/每小時輪詢)

訊號定義(相對)角色
異常波動z = day_return / sigma_20d(亦有 5d/1m/YTD、跳空、開盤至收盤)核心
殘差波動residual = ticker_return − explained_market_sector_move;當市場+板塊解釋不到一半的波動時標記核心
板塊相對z of (ticker_return − sector_benchmark_return) ≥ 2.0核心
成交量異常RVOL = vol / avg_vol(根據時段調整);2× 值得注意,3× 強烈,5×+ 重大催化劑。5×+ 通常是高潮/耗竭,而非持續——需結合價格方向解讀確認器
周轉率vol / free_float ≥ 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、可轉債、增發)、Form 4 內部人交易、13D 激進投資者持股。升級公開市場內部人買入、高層集體買入、對燒錢公司的融資、激進投資者 13D。已建置 (v1): 一個聰明錢持倉 overlay 計算自行決定的公開市場 Form-4 買入/賣出(排除 10b5-1);一群內部人(或 CEO)在買入是一個確認器,並在價格疲軟時提供一個看漲背離的預警——以投資組合背景形式顯示,絕不會是單一股票的推播。降級例行性的 10b5-1 銷售和機械性的分割/股利調整。
  • 閉鎖期 / PIPE 解鎖(SPAC),贖回風險。
  • 宏觀日曆(FOMC、CPI、利率、美元、油價)僅在投資組合對其敏感時(高 beta 或利率/商品敏感板塊)或數個持股共享該曝險時——否則對這個使用者來說是噪音。

層 C — 資訊與敘事(新聞驅動,無法提前知道)

  • 重大公司新聞:M&A、訴訟、監管行動、高階主管變動、重大產品失敗/召回(Data Skills 新聞 + unified_search 獲取背景資訊)。
  • 預估與評級變更——彙總,絕非逐條:一個小的修正屬於噪音;一個大範圍的同向修正集群,或一個伴隨預估/論點變更的目標價變更,則是一個訊號。
  • 需要多個可信來源;壓制轉發的舊聞、單一來源的謠言和泛泛的市場評論。社交媒體速度僅為弱訊號。
  • 半導體週期(TrendForce DXI 記憶體指數) — 已建置 (v1) 作為板塊背景 overlay:DXI 趨勢與其 30/60 日均線的比較 = 映射到半導體持股的記憶體週期順風/逆風(對記憶體名稱最直接;對 GPU/AI 透過 HBM 提供廣泛的週期解讀)。板塊資金流(輪動)和共識預估修正動量被規格化為傳統的確認器。
  • 預測市場(Polymarket)作為結構化事件訊號 — 對於具有流動性市場的事件(聯準會決策、選舉、一些催化劑),事件機率的急劇變動是一個量化的、通常是早期的重新定價。

…

[為翻譯截斷]

相關技能