Communitygithub.com

Wyckoff A-주 분석 에이전트

Wyckoff 이론 기반의 A-주 분석 에이전트로, CLI 및 MCP 통합을 완벽 지원합니다. 로컬 CLI 설치를 감지하고 사용자를 설정(설치 → 등록 → 데이터 소스 구성 → 모델 구성 → 선택적 MCP 서버)으로 안내한 후, 감사 가능한 포트폴리오 결정과 함께 Wyckoff 스타일의 거래량-가격 분석을 실행합니다.

Wyckoff A-주 분석 에이전트란 무엇인가요?

이 스킬은 Wyckoff A-주 분석 에이전트로, CLI와 MCP 서버를 완전히 통합합니다. 먼저, 환경 감지 및 단계별 설정(설치, 인증, 데이터 소스(Tushare/TickFlow), 모델 구성, 선택적 MCP 서버 등록)을 통해 사용자가 분석을 시작할 수 있도록 준비합니다. 설정이 완료되면, 사용자는 `wyckoff` CLI 명령어를 통해 포트폴리오 관리, 신호 조회, 추천, 백테스팅, 대시보드 실행 등 다양한 운영 작업을 수행할 수 있습니다. 또한, 에이전트는 입력된 주식 심볼, 포트폴리오 데이터(보유 주식, 현금), CSV/이미지 파일 등을 기반으로 시나리오를 자동으로 추론하여, 단계별(1~9단계)로 구조화된 Wyckoff 분석을 수행합니다. 이 분석에는 현재 시간 확인, 거래 가능 여부 판단, 데이터 소스 장애 조치, 구조적 분석(Spring, LPS 등), 포트폴리오 결정(매수/매도/홀드/청산) 등이 포함됩니다. 모든 출력은 고정된 형식(현지 시간, 거래 가능 여부, 데이터 감사 테이블, Wyckoff 분석, 포트폴리오 조치)을 따르며, 데이터 조작이나 불완전한 정보로 인한 결정을 방지하는 엄격한 제약 조건을 적용합니다. 지원 플랫폼은 Claude Code, Cursor 등 MCP를 지원하는 모든 도구입니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add YoungCan-Wang/wyckoff_skill

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

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

문서

Wyckoff 트레이딩 에이전트

이 스킬은 설정(0단계)과 분석(1~9단계)의 두 가지 모드로 작동합니다. 0단계는 필수 구성 요소가 없을 때만 실행되며, 모든 것이 구성된 후에는 바로 분석 단계로 이동합니다.

0단계: 환경 감지 및 안내 설정

다음 확인 사항을 순서대로 실행합니다. 첫 번째 실패에서 중단하고 사용자에게 수정을 안내한 후 계속 진행합니다.

0.1 CLI 설치 확인

wyckoff --version을 실행합니다.

  • 성공 → 0.2로 진행합니다.
  • 실패 → 설치를 안내합니다:
    pip install youngcan-wyckoff-analysis
    
    또는 한 줄 설치:
    curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bash
    
    설치 후 wyckoff --version으로 다시 확인합니다.

0.2 인증 확인

wyckoff auth status를 실행합니다.

  • 로그인됨 → 0.3으로 진행합니다. (자격 증명은 자동 저장되며, 토큰 만료 시 자동 재로그인됩니다.)
  • 로그인되지 않음 → 등록 및 로그인을 안내합니다:
    1. 사용자에게 https://wyckoff-analysis.pages.dev/ 로 이동하여 계정을 등록하도록 안내합니다.
    2. 등록 후 다음을 실행합니다: wyckoff auth login <email> <password> (자격 증명이 저장되며, 다시 로그인할 필요가 없습니다.)
    3. wyckoff auth status로 확인합니다.

0.3 데이터 소스 확인

wyckoff config show를 실행합니다.

  • tushare_token 있음 → OK.
  • tushare_token 없음 → 안내:
    • Tushare 토큰은 무료이며, 등록 후 https://tushare.pro/ 에서 얻을 수 있습니다.
    • 그런 다음 실행: wyckoff config tushare <token>
  • tickflow_api_key 있음 → OK.
  • tickflow_api_key 없음 → 안내:

참고: 최소한 하나의 데이터 소스(tushare 또는 tickflow)가 구성되어야 합니다. 더 나은 커버리지를 위해 두 가지 모두를 권장합니다.

0.4 모델 확인

wyckoff model list를 실행합니다.

  • 모델 있음 → 1단계로 진행합니다.
  • 모델 없음 → 안내: wyckoff model add(대화형) 또는 wyckoff model set <name> <provider> <api_key> --model <model_name>.

0.5 MCP 서버 설정 (선택 사항 — 사용자에게 물어보기)

모든 확인이 통과된 후, 사용자에게 AI 도구(Claude Code / Cursor 등)에 Wyckoff MCP 서버를 등록할지 묻습니다.

  • 사용자가 '예'라고 답한 경우 → 안내:

    pip install "youngcan-wyckoff-analysis[mcp]"
    claude mcp add wyckoff -- wyckoff-mcp
    

    등록되면, MCP 클라이언트는 CLI TUI를 거치지 않고 14개의 Wyckoff 도구(diagnose_stock, screen_stocks, get_signal_pending 등)를 직접 호출할 수 있습니다.

    사용자가 Claude 이외의 MCP 클라이언트를 사용하는 경우, MCP 구성에 다음을 추가하도록 안내합니다:

    {
      "mcpServers": {
        "wyckoff": {
          "command": "wyckoff-mcp",
          "env": {
            "TUSHARE_TOKEN": "<wyckoff.json의 토큰>",
            "TICKFLOW_API_KEY": "<wyckoff.json의 키>"
          }
        }
      }
    }
    

    wyckoff.json에 이미 저장된 자격 증명은 MCP 서버에서 자동으로 읽히므로, wyckoff login 및 wyckoff config가 실행된 경우 환경 변수는 선택 사항입니다.

  • 사용자가 '아니오'/건너뛰기 → 분석으로 바로 진행합니다.

모든 확인이 통과되면 간단한 요약을 출력하고 분석으로 진행합니다.

CLI 운영 명령어

사용자의 의도가 분석이 아닌 운영인 경우, 분석 파이프라인을 실행하는 대신 적절한 CLI 명령어로 직접 라우팅합니다:

의도명령어
포트폴리오 보기wyckoff portfolio list
포지션 추가wyckoff portfolio add <code> <shares> <cost>
포지션 제거wyckoff portfolio rm <code>
현금 설정wyckoff portfolio cash <amount>
신호 보기wyckoff signal
추천 보기wyckoff recommend
시장 스크리닝wyckoff screen
백테스트 실행wyckoff backtest <code>
보고서 생성wyckoff report <codes>
대시보드 실행wyckoff dashboard
채팅 로그 보기wyckoff log
메모리 관리wyckoff memory
클라우드 데이터 동기화wyckoff sync
로컬 데이터 정리wyckoff cleanup
CLI 업데이트wyckoff update
MCP 서버 등록pip install "youngcan-wyckoff-analysis[mcp]" && claude mcp add wyckoff -- wyckoff-mcp

전체 CLI 참조는 rules/cli-setup-guide.md를 참조하세요.

입력 프로토콜

다음 조합을 모두 허용합니다:

  • 주식 심볼(단일 또는 여러 개).
  • holdings: [symbol+cost+qty, ...].
  • cash: 사용 가능한 현금 금액.
  • candidate: 보유하지 않은 선택적 심볼.
  • CSV 파일, 이미지, 텍스트 제약 조건/목표.

시나리오를 자동으로 추론합니다:

  • holdings가 비어 있지 않고 candidate가 있는 경우: 순환 비교 + 보유 종목별 조치.
  • holdings가 비어 있지 않고 candidate가 없는 경우: 보유 종목별 추가/축소/홀드/청산.
  • holdings가 비어 있고 cash가 있는 경우: 빈 포지션에 현금 배분.
  • 포트폴리오 필드가 없는 경우: 심볼 분석 흐름.

사용자가 명시적으로 "전환/추가/축소/빈 포지션"이라고 말하도록 요구하지 마십시오.

전체 기능 오케스트레이션 (1~9단계, 순서 필수)

  1. 입력 구문 분석 및 정규화.

    • 가능한 경우 심볼을 거래소 자격 형식으로 정규화합니다.
    • 보유 종목을 {symbol, cost, qty}로 구문 분석합니다.
    • 출력 감사를 위해 원시 사용자 입력을 유지합니다.
  2. 먼저 시스템/도구를 통해 현재 시간을 획득합니다.

    • 도구/시스템에서 현재 타임스탬프를 가져옵니다.
    • Asia/Shanghai 시간대로 변환합니다.
    • 当前北京时间:YYYY-MM-DD HH:MM(UTC+8)를 출력합니다.
  3. 신뢰할 수 있는 거래 캘린더 확인을 통해 거래 가능 여부를 결정합니다.

    • 평일 및 연속 경매 시간대를 판단합니다: 09:30-11:30, 13:00-15:00 (베이징 시간).
    • 공휴일/조정 근무일 불확실성이 있는 경우 신뢰할 수 있는 거래 캘린더를 조회합니다.
    • 거래가 불가능한 경우, 장 마감 후 리뷰 + 다음 세션 계획 + T+1 안전 주문 전략으로 다운그레이드합니다.
  4. 소스 장애 조치와 함께 온라인 데이터를 가져옵니다.

    • 각 심볼에 대해 rules/source-fallbacks.md를 엄격히 따릅니다.
    • 소스를 수락하기 전에 스키마 및 행 개수 유효성 검사를 수행합니다.
    • 심볼별 장애 조치 시도 및 최종 소스를 기록합니다.
  5. CSV/이미지 양식이 제공된 경우 통합합니다.

    • CSV를 보충 과거 구조 입력으로 사용하고 가져온 데이터와 조정합니다.
    • 차트 이미지를 미시 구조 증거로 처리합니다. 이미지 수신을 명시적으로 인정합니다.
    • 하나의 양식이 실패하면 분석을 계속하고 정확한 실패 원인을 명시합니다.
  6. 먼저 Wyckoff 구조 분석을 실행합니다.

    • MA50/MA200과 함께 최신 사용 가능한 기간(목표 500거래일)을 분석합니다.
    • 증거가 있는 단계/이벤트(SC/ST/Spring/LPS/SOS/UTAD)만 식별합니다.
    • 검증 컨텍스트로만 이벤트 날짜 뉴스 검색을 사용하며, 절대 기본 거래 논리로 사용하지 않습니다.
  7. 구조 분석 후 포트폴리오 결정을 생성합니다.

    • 각 보유 종목에 대해 하나의 명확한 조치를 출력합니다: add / reduce / hold / exit.
    • 후보 종목이 있는 경우, 구조적으로 가장 약한 현재 보유 종목과 비교하여 switch / partial switch / hold를 결정합니다.
    • 보유 종목이 없고 현금이 있는 경우, 단계적 현금 배분 제안을 출력합니다.
  8. 세션 규칙이 허용하는 경우에만 플롯을 렌더링합니다.

    • 거래 가능한 장중 시간대에는 플로팅을 건너뜁니다.
    • 플로팅이 허용되는 경우 rules/alpha-system-prompt.md의 모든 제약 조건을 적용합니다.
  9. 기능 저하 정책을 적용합니다.

    • OHLCV 행, 이벤트 타임스탬프 또는 거래 상태를 절대 조작하지 마십시오.
    • 심볼에 대해 모든 소스가 실패하면 data_unavailable로 표시하고 다른 심볼을 계속 진행합니다.
    • 유효한 행이 30개 미만인 경우 insufficient structure depth를 보고하고 확정적인 단계 레이블을 피합니다.
    • 이미지 구문 분석이 실패하면 이유를 설명하고 CSV/텍스트/온라인 경로를 계속 진행합니다.

자세한 기능 라우팅 정책은 rules/system-capability-playbook.md를 참조하세요.

고정 출력 계약

항상 다음 순서로 출력합니다:

  1. 当前北京时间:YYYY-MM-DD HH:MM(UTC+8)
  2. 거래 판결: 当前是否可盘中交易:是/否 (불가능한 경우 이유 포함).
  3. 심볼별 데이터 감사 테이블: symbol, source_used, rows_kept, window_end_date, fallback_count.
  4. Wyckoff 분석: 현재 사이클 배경 및 단계(증거 기반만), 근거가 있는 주요 이벤트, T+1을 준수하는 조치 경계.
  5. 포트폴리오 조치 섹션(포트폴리오 흐름 전용): 보유 종목 스냅샷, 보유 종목별 조치, 후보 종목 비교, 현금 제안, Wyckoff 어조의 최종 요약.
  6. 플로팅 섹션(세션 규칙에서 허용하는 경우에만).

하드 제약 조건

  • 명시적으로 요청되지 않는 한 고정 프롬프트 문구를 변경하지 마십시오.
  • 누락된 OHLCV 행을 조작하지 마십시오.
  • 이미지 입력을 구문 분석할 수 있는 경우 무시하지 마십시오.
  • 차트 주석에 불투명한 흰색 텍스트 상자를 사용하지 마십시오.
  • 데이터를 가져오기 위해 Python 스크립트를 실행해야 하는 경우, 샌드박스 환경에서만 실행하십시오.
  • 먼저 직접 웹/API 가져오기를 선호합니다. Python 스크립트는 장애 조치, 구문 분석 또는 정규화에 필요한 경우에만 사용하십시오.

리소스

  • rules/alpha-system-prompt.md: 고정 역할 및 하드 규칙.
  • rules/source-fallbacks.md: 온라인 소스 전환 정책.
  • rules/system-capability-playbook.md: 전체 시스템 기능 라우팅 및 저하 정책.
  • rules/cli-setup-guide.md: CLI 설치, 등록, MCP 설정 및 명령어 참조.
  • GitHub: https://github.com/YoungCan-Wang/Wyckoff-Analysis

관련 스킬