Communitygithub.com

Portfolio Watch

모든 포트폴리오를 실시간 대시보드 + 조용한 순위 경고로 바꿔주는 재사용 가능한 Alva 스킬입니다. 시장뿐만 아니라 매수 논리(thesis)를 관찰합니다. Alva 기반으로 구축되었으며, 5년 데이터로 백테스트되고 실시간 운영됩니다.

Portfolio Watch란 무엇인가요?

Portfolio Watch 스킬은 사용자가 한 줄의 요청(예: "내 NVDA, TSLA, AAPL을 감시하고 큰 변화가 생기면 알려줘")만으로 개인화된 포트폴리오 감시 플레이북을 즉시 생성하도록 설계된 Alva AI 에이전트 스킬입니다. 이 스킬은 단순한 가격 알림이 아닌, 각 보유 종목의 통계적 기준선(변동성, 베타, 잔차 변동성 등)을 기반으로 상대적 이상 징후를 감지하여, 시장 소음과 중요한 투자 신호를 구분합니다. 특히 '매수 논리(thesis)' 기반 모니터링을 지원하여 사용자가 특정 종목을 보유한 이유를 파악하고, 그 논리와 관련된 이벤트(예: MSTR을 비트코인 레버리지 플레이로 보유 중일 때 비트코인 가격 급변)에 집중하여 알림을 제공합니다. 사용자는 디스코드, 텔레그램, 슬랙 등으로 푸시 알림을 받으며, 각 알림은 포트폴리오 대시보드의 관련 카드로 딥링크됩니다. 모든 이상 징후는 해당 종목의 과거 데이터와 시장/섹터 상황을 고려한 상대적 임계값을 사용하므로, 스킬을 한 번만 개발해도 어떤 포트폴리오든 즉시 적용 가능합니다. Alva의 원시 빌드 도구(Data Skills, Feed, Playbook, Push 등)를 기반으로 작동하며, 에이전트는 자동으로 포트폴리오 설정을 완료하고 대시보드를 구축합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add george351419-sys/Portfolio-Watch-Skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Portfolio Watch은(는) 무엇을 하나요?

"내 NVDA, TSLA, AAPL을 감시하고 큰 일이 생기면 알려줘" 같은 한 줄 요청을 호스팅된 Portfolio Watch Playbook으로 전환합니다: 사용자가 보유 종목 현황을 확인하고, 조용하고 순위가 매겨진 푸시 알림을 휴대폰으로 수신하며, 알림과 연결된 카드로 딥링크되는 인터페이스입니다.

이 스킬은 방법론 청사진입니다. Alva의 빌드 메커니즘을 대체하지 않고, 이를 구동합니다. Alva는 기본 요소(데이터 스킬, 런타임 피드, Altra, alpi, 플레이북 릴리스, 푸시)를 소유합니다. 이 스킬은 모니터링 판단(차원, 임계값, 노이즈 필터, 순위)을 소유합니다. 두 파일이 메커니즘에서 충돌하면 alva 스킬을 따르고; 무엇을 보고 무엇을 말할지에서는 이 파일을 따릅니다. 제품 목표는 시그널이며, 커버리지가 아닙니다 — 한 번도 본 적 없는 포트폴리오에서 물질적 투자 신호를 시장 소음과 분리하는 것입니다.

핵심 원칙: 모든 임계값은 상대적입니다

하드코딩된 백분율 임계값은 없습니다. NVDA가 3% 하락하는 것은 평범한 날입니다. 코카콜라가 3% 하락하는 것은 뉴스입니다. 이 스킬은 본 적 없는 포트폴리오에서 작동합니다. 모든 이상 징후 테스트는 해당 보유 종목의 자체 통계적 기준선과 오늘 시장과 해당 섹터가 어떻게 움직였는지에 대해 측정되며, 설정 시 계산됩니다. 이것이 전체 재사용성 엔진입니다. 이것을 제대로 하면 나머지는 따라옵니다.

빌드 순서 (Alva 기본 요소에 매핑)

alva 스킬의 세션 시작 및 게이트를 따릅니다. 스킬 관련 순서는 다음과 같습니다:

  1. 인테이크 — 보유 종목, 가중치, 의도, 알림 채널, 시간 지평선을 파싱합니다.
  2. 프로필 피드 — 보유 종목별 기준선 + 벤치마크 라우팅(재사용성 엔진). 먼저 구축하십시오. 모든 임계값이 여기서 값을 읽습니다.
  3. 감시 피드 — 점수가 매겨진 신호를 방출하는 모니터링 레이어입니다.
  4. 플레이북 인터페이스 — 실시간 읽기 HTML, 네 개의 탭(Watch / Incident / Theory / Formulas — §인터페이스 참조). Theory와 Formulas는 필수이며 선택 사항이 아닙니다.
  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 (시장 가치 / 총계에서), sector}로 매핑하고 감시 세트 구성(아래)에 기록합니다. 가중치는 실제 잔액에서 무료로 제공되므로 순위가 균등 가중치 대신 정확합니다.
  3. 모니터링 전에 확인된 목록을 한 줄로 사용자에게 확인하십시오. 그런 다음 피드가 모든 이름을 자동으로 프로파일링하고(§2단계) 논리 프롬프트가 이어집니다.
  4. 요청 시 동기화 — "내 포트폴리오 동기화"는 계정을 다시 읽고 구성을 diff합니다(새 매수 추가, 완전히 매도된 종목 제거). 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 (장중 시 시간대별)거래량 히스토리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_low캔들 데이터마일스톤 신호

느린 주기(일별/주별)로 새로 고칩니다. 모든 다운스트림 임계값은 이 피드에서 값을 읽습니다 — 포트폴리오를 변경하면 동일한 규칙이 자동으로 다시 맞춰집니다. 새로 상장되거나 거래량이 적은 종목의 경우 더 강력한 증거를 요구하고 신뢰도를 낮게 표시합니다.

인식할 자산 유형: 보통주, ADR, ETF/ETP, 폐쇄형 펀드, REIT, BDC, MLP, 우선주, SPAC/디SPAC, 암호화폐 자산, 암호화폐 연결 주식(거래소, 채굴업체, 재무부 회사, 브로커, 스테이블코인/결제 프록시 — COIN, MSTR, MARA, RIOT, CLSK, HOOD), 기타 상장 증권. 보유 종목이 여러 템플릿에 걸쳐 있으면 모든 중요한 템플릿을 적용하고 주요 동인을 표시합니다.

3단계 — 무엇을 감시할지 (계층화된 모델)

데이터 출처가 아닌 투자자가 중요시하는 이유별로 구성합니다. 보편적 모니터는 데이터가 존재하는 모든 보유 종목에 적용되며, 템플릿은 자산별 인텔리전스를 추가합니다.

레이어 A — 가격, 상대 성과, 유동성 (장중/시간별 폴링)

신호정의 (상대적)역할
비정상 움직임z = day_return / sigma_20d (5일/1개월/YTD, 갭, 시초가-종가도 포함)핵심
잔차 움직임residual = ticker_return − 설명된_시장_섹터_움직임. 시장+섹터가 움직임의 절반 미만을 설명하면 플래그핵심
섹터 상대z of (티커_수익률 − 섹터_벤치마크_수익률) ≥ 2.0핵심
거래량 이상RVOL = 거래량 / 평균_거래량(시간대 조정). 2배 주목, 3배 강함, 5배+ 주요 촉매. 5배+는 종종 절정/소진 신호이므로 지속 신호가 아님 — 가격 방향과 함께 읽을 것확인기
회전율거래량 / 유동 주식수 ≥ 60일 중앙값의 2배 또는 90번째 백분위수 초과. 좋은 뉴스 후 높은 회전율 + 상승 실패 = 분배(distribution)확인기
유동성 스트레스유동성 높은 종목에서 매수-매도 스프레드 > 90번째 백분위수; 정지, LULD, SSR확인기
레인지 돌파거래량 확인과 함께 20/50/200일 돌파, 또는 52주 신고가/신저가, 사상 최고가/최저가약함
느린 추세N일 연속 하락, 또는 5일 누적 움직임 > 2σ (일별로는 유의미하지 않지만 누적적으로 유의미)느림

레이어 B — 이벤트 및 공시 (캘린더/공시 기반; 사전에 알 수 있는 경우가 많음)

  • 실적: 사전 발표 알림(T−1/2) + 결과 vs 추정 + 가이던스 변경.
  • 배당금/분할/물적분할/배당락; 지수 변경; ETF 리밸런싱.
  • 공시 및 소유권: 8-K 중요 사건, 10-Q/10-K, 계속기업 불확실성, 감사인 변경/지연 제출, 재작성, 자금 조달/희석(S-1/S-3/424B/ATM, 전환사채, 유상증자), Form 4 내부자 거래, 13D 활동가 지분. 상향: 공개 시장 내부자 매수, 임원 집단 매수, 현금 소진 기업의 자금 조달, 활동가 13D. 구축됨(v1): 스마트 머니 포지셔닝 오버레이는 재량적 공개 시장 Form-4 매수/매도(10b5-1 제외)를 집계합니다. 내부자(또는 CEO)의 집단 매수는 가격이 약할 때 확인기이자 강세 다이버전스 주의 신호입니다 — 포트폴리오 컨텍스트로 표시되며, 종목별 푸시는 절대 없습니다. 하향: 일상적인 10b5-1 매도 및 기계적 분할/배당 조정.
  • 락업/PIPE 해제(SPAC), 상환 위험.
  • 거시 캘린더(FOMC, CPI, 금리, 달러, 원유) 포트폴리오가 민감한 경우에만(고베타 또는 금리/원자재 노출 섹터) 또는 여러 보유 종목이 노출을 공유하는 경우 — 그렇지 않으면 이 사용자에게는 노이즈입니다.

레이어 C — 정보 및 내러티브 (뉴스 기반, 사전 예측 불가)

  • 중요한 회사 뉴스: M&A, 소송, 규제 조치, 임원 변경, 주요 제품 실패/리콜(데이터 스킬 뉴스 + unified_search로 컨텍스트).
  • 추정 및 등급 변경 — 집계됨, 개별 라인별 없음: 하나의 작은 수정은 노이즈입니다. 동일 방향의 광범위한 수정 클러스터 또는 추정/논리 변경이 있는 목표가 변경은 신호입니다.
  • 여러 신뢰할 수 있는 출처 필요; 재게시된 오래된 뉴스, 단일 출처 루머, 일반 시장 논평은 억제합니다. 소셜 속도는 약한 신호일 뿐입니다.
  • 반도체 사이클(TrendForce DXI 메모리 지수) — 구축됨(v1) 섹터 컨텍스트 오버레이로: DXI 추세 대 30/60일 MA = 반도체 보유 종목에 매핑된 메모리 사이클 순풍/역풍(메모리 종목에 가장 직접적; HBM을 통한 GPU/AI에 대한 광범위한 사이클 읽기). 섹터 자금 흐름(로테이션) 및 컨센서스 추정 수정 모멘텀은 기존 확인기로 지정됩니다.
  • 예측 시장(Polymarket)을 구조화된 이벤트 신호로 — 유동적인 시장이 있는 이벤트(연준 결정, 선거, 일부 촉매)의 경우, 이벤트 확률의 급격한 변동은 정량화되고 종종 조기 재평가입니다. U……

[번역을 위해 잘림]

관련 스킬