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 | bashwyckoff --version으로 다시 확인합니다.
0.2 인증 확인
wyckoff auth status를 실행합니다.
- 로그인됨 → 0.3으로 진행합니다. (자격 증명은 자동 저장되며, 토큰 만료 시 자동 재로그인됩니다.)
- 로그인되지 않음 → 등록 및 로그인을 안내합니다:
- 사용자에게 https://wyckoff-analysis.pages.dev/ 로 이동하여 계정을 등록하도록 안내합니다.
- 등록 후 다음을 실행합니다:
wyckoff auth login <email> <password>(자격 증명이 저장되며, 다시 로그인할 필요가 없습니다.) 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 없음 → 안내:
- TickFlow는 실시간 및 과거 A-주 데이터를 제공합니다.
- https://tickflow.org/auth/register?ref=5N4NKTCPL4 에서 구매합니다.
- 그런 다음 실행:
wyckoff config 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단계, 순서 필수)
-
입력 구문 분석 및 정규화.
- 가능한 경우 심볼을 거래소 자격 형식으로 정규화합니다.
- 보유 종목을
{symbol, cost, qty}로 구문 분석합니다. - 출력 감사를 위해 원시 사용자 입력을 유지합니다.
-
먼저 시스템/도구를 통해 현재 시간을 획득합니다.
- 도구/시스템에서 현재 타임스탬프를 가져옵니다.
Asia/Shanghai시간대로 변환합니다.当前北京时间:YYYY-MM-DD HH:MM(UTC+8)를 출력합니다.
-
신뢰할 수 있는 거래 캘린더 확인을 통해 거래 가능 여부를 결정합니다.
- 평일 및 연속 경매 시간대를 판단합니다:
09:30-11:30,13:00-15:00(베이징 시간). - 공휴일/조정 근무일 불확실성이 있는 경우 신뢰할 수 있는 거래 캘린더를 조회합니다.
- 거래가 불가능한 경우, 장 마감 후 리뷰 + 다음 세션 계획 + T+1 안전 주문 전략으로 다운그레이드합니다.
- 평일 및 연속 경매 시간대를 판단합니다:
-
소스 장애 조치와 함께 온라인 데이터를 가져옵니다.
- 각 심볼에 대해
rules/source-fallbacks.md를 엄격히 따릅니다. - 소스를 수락하기 전에 스키마 및 행 개수 유효성 검사를 수행합니다.
- 심볼별 장애 조치 시도 및 최종 소스를 기록합니다.
- 각 심볼에 대해
-
CSV/이미지 양식이 제공된 경우 통합합니다.
- CSV를 보충 과거 구조 입력으로 사용하고 가져온 데이터와 조정합니다.
- 차트 이미지를 미시 구조 증거로 처리합니다. 이미지 수신을 명시적으로 인정합니다.
- 하나의 양식이 실패하면 분석을 계속하고 정확한 실패 원인을 명시합니다.
-
먼저 Wyckoff 구조 분석을 실행합니다.
MA50/MA200과 함께 최신 사용 가능한 기간(목표 500거래일)을 분석합니다.- 증거가 있는 단계/이벤트(SC/ST/Spring/LPS/SOS/UTAD)만 식별합니다.
- 검증 컨텍스트로만 이벤트 날짜 뉴스 검색을 사용하며, 절대 기본 거래 논리로 사용하지 않습니다.
-
구조 분석 후 포트폴리오 결정을 생성합니다.
- 각 보유 종목에 대해 하나의 명확한 조치를 출력합니다:
add / reduce / hold / exit. - 후보 종목이 있는 경우, 구조적으로 가장 약한 현재 보유 종목과 비교하여
switch / partial switch / hold를 결정합니다. - 보유 종목이 없고 현금이 있는 경우, 단계적 현금 배분 제안을 출력합니다.
- 각 보유 종목에 대해 하나의 명확한 조치를 출력합니다:
-
세션 규칙이 허용하는 경우에만 플롯을 렌더링합니다.
- 거래 가능한 장중 시간대에는 플로팅을 건너뜁니다.
- 플로팅이 허용되는 경우
rules/alpha-system-prompt.md의 모든 제약 조건을 적용합니다.
-
기능 저하 정책을 적용합니다.
- OHLCV 행, 이벤트 타임스탬프 또는 거래 상태를 절대 조작하지 마십시오.
- 심볼에 대해 모든 소스가 실패하면
data_unavailable로 표시하고 다른 심볼을 계속 진행합니다. - 유효한 행이 30개 미만인 경우
insufficient structure depth를 보고하고 확정적인 단계 레이블을 피합니다. - 이미지 구문 분석이 실패하면 이유를 설명하고 CSV/텍스트/온라인 경로를 계속 진행합니다.
자세한 기능 라우팅 정책은 rules/system-capability-playbook.md를 참조하세요.
고정 출력 계약
항상 다음 순서로 출력합니다:
当前北京时间:YYYY-MM-DD HH:MM(UTC+8)- 거래 판결:
当前是否可盘中交易:是/否(불가능한 경우 이유 포함). - 심볼별 데이터 감사 테이블:
symbol,source_used,rows_kept,window_end_date,fallback_count. - Wyckoff 분석: 현재 사이클 배경 및 단계(증거 기반만), 근거가 있는 주요 이벤트, T+1을 준수하는 조치 경계.
- 포트폴리오 조치 섹션(포트폴리오 흐름 전용): 보유 종목 스냅샷, 보유 종목별 조치, 후보 종목 비교, 현금 제안, Wyckoff 어조의 최종 요약.
- 플로팅 섹션(세션 규칙에서 허용하는 경우에만).
하드 제약 조건
- 명시적으로 요청되지 않는 한 고정 프롬프트 문구를 변경하지 마십시오.
- 누락된 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