| name | stock-help |
| description | Show all available Stock Expectation commands — Claude Code skills, bin/stock-cli subcommands, and common workflows. Use when the user asks "what commands are available", "how do I use this", "show me skills", or 명령어 알려줘 / 도움말 / 어떤 스킬 있어 / 사용법 / 뭐 할 수 있어 / stock help. |
Stock Expectation — Command Reference
이 프로젝트가 제공하는 모든 명령을 한눈에 정리한 도움말. 더 자세한 워크플로는 README.md, cron_setting.md, docs/HANDOFF.md 참조.
가장 자주 쓰는 5개
| 명령 | 용도 |
|---|
/expect <ticker> 또는 /expect ALL | 결정론적 BUY/SELL 추천 — 점수 테이블 + multi-horizon 예측 자동 등록 |
/daily-briefing | 일일 시장 브리핑 (자동 cron도 매일 07:00 KR, 21:00 US) |
/prediction-review | 내 예측 적중률 / 시그널별 성과 / 캘리브레이션 |
/portfolio-eval | 포트폴리오 P&L, 리스크, 어드바이스 |
./bin/stock-cli price <ticker> --market US | 터미널에서 빠른 가격 조회 (LLM 우회) |
Claude Code 스킬 (대화형, /명령 또는 자연어로 호출)
1. 핵심 예측 흐름 (4)
/expect — 결정론적 추천기. 모드:
/expect NVDA 또는 /expect 삼성전자 — 단일 종목 깊은 분석/expect NVDA,AMD,AVGO — 배치 (≤5개)/expect US / /expect KR — 시장별 자동 발굴 5개/expect ALL 또는 /expect — US 5 + KR 5 풀 스캔
/daily-briefing — 시장 매크로 + 섹터 + 3-5개 종목 추천 (자동 cron에서도 호출)/stock-research — 5-signal 가중 분석 (/expect보다 narrative 중심)/prediction-review — 적중률 / Brier / 시그널 성과 / 과신 버킷
2. 포트폴리오 (5)
/portfolio-eval — 4축 분석 (P&L / 리스크 / 예측 일치도 / 어드바이스)/portfolio-manager — Alpaca 브로커리지 연동 분석/position-sizer — 리스크 기반 매수 수량 계산 (Kelly, ATR 등)/toss-sync — Toss 증권 자동 동기화/trader-memory-core — 투자 thesis 생애주기 추적 (등록 → 진입 → 마감 → postmortem)
3. 매크로 / 시장 환경 (6)
/macro-regime-detector — Concentration / Broadening / Contraction 레짐 분류/market-breadth-analyzer — 시장 폭 0-100 점수/market-top-detector — 천장 신호 (distribution days 등)/ftd-detector — Follow-Through Day (바닥 확인)/uptrend-analyzer — 5-component breadth dashboard/sector-analyst — 섹터 로테이션 사이클 위치
4. 스크리너 (5) — 다양한 종목 발굴
/vcp-screener — Minervini VCP (Stage 2 momentum)/canslim-screener — O'Neil CANSLIM (성장주)/base-breakout-screener — 6M 베이스 + 거래량 200% 폭발/earnings-trade-analyzer — 어닝스 직후 5-factor 점수/finviz-screener — "P/E < 20, ROE > 15%" 같은 자연어 → FinViz URL 빌더
5. 캘린더 + 분석 (5)
/earnings-calendar — FMP 어닝스 캘린더 (mid-cap+)/economic-calendar-fetcher — 중앙은행, 고용, CPI 등 매크로 이벤트/theme-detector — 테마/섹터 라이프사이클/technical-analyst — 주간 차트 기술적 분석 (이미지 업로드 가능)/stock-analysis — US 종합 펀더+테크니컬
6. 한국 시장 (1)
/korean-market-analysis — KOSPI/KOSDAQ, 재벌, 환율 영향, 반도체 공급망 등 한국 특화
7. 메타 / 운영 (5)
/backtest-expert — 백테스트 설계 가이드/data-quality-checker — 마켓 분석 문서 QA/signal-postmortem — 시그널 사후 분석/retrospect — 세션 회고 문서 생성/init — CLAUDE.md 초기화
8. 메타 (이 스킬)
Archived 19 + Deleted 11: Stage 3 정리 후 보관/삭제됨. 복원 방법은 .claude/skills/_archived/README.md 참조.
bin/stock-cli — 터미널 직접 호출 (LLM 우회)
JSON으로만 출력. jq와 조합 가능.
시장 데이터
./bin/stock-cli price NVDA --market US --days 30
./bin/stock-cli price-batch AAPL,MSFT,NVDA --market US --days 30
./bin/stock-cli fundamentals AAPL --market US
./bin/stock-cli fundamentals-batch AAPL,MSFT --market US
./bin/stock-cli search "삼성" --market KR
./bin/stock-cli health
Multi-horizon 지표 (/expect가 사용)
./bin/stock-cli horizon-metrics NVDA --market US --days 400
./bin/stock-cli horizon-metrics-batch NVDA,AMD,AVGO --market US --days 400
뉴스 + 공시
./bin/stock-cli news NVDA --market US --limit 5 --since-days 7
./bin/stock-cli news 005930 --market KR --limit 5 --since-days 7
./bin/stock-cli disclosure 005930 --since-days 14
예측 관리
./bin/stock-cli predict create \
--ticker NVDA --market US --direction BULL \
--confidence 0.65 --timeframe 1W --entry-price 215.20 \
--target-price 226.00 --stop-price 206.60 \
--reasoning "..." --signals technical,news,momentum
./bin/stock-cli predict list --status OPEN
./bin/stock-cli predict detail <id>
./bin/stock-cli predict cancel <id>
./bin/stock-cli track-record --days 30
./bin/stock-cli calibration
포트폴리오
./bin/stock-cli portfolio create --market KR --name "Toss KR"
./bin/stock-cli portfolio buy 005930 --qty 10 --price 55000 --market KR
./bin/stock-cli portfolio sell 005930 --qty 5 --price 60000 --market KR --date 2026-04-01
./bin/stock-cli portfolio import trades.csv --market KR --dry-run
./bin/stock-cli portfolio positions --market KR
./bin/stock-cli portfolio report --market KR
./bin/stock-cli portfolio risk --market KR
./bin/stock-cli portfolio vs-predictions --market KR
./bin/stock-cli portfolio advice --market KR
옵션 모듈 (별도 --extra 설치 필요)
./bin/stock-cli memory stats
./bin/stock-cli memory search "AI infrastructure" --category predictions --limit 5
./bin/stock-cli memory purge <id> --yes
./bin/stock-cli graph init
./bin/stock-cli graph query "MATCH (n) RETURN count(n)"
./bin/stock-cli graph similar-stocks NVDA --limit 5
./bin/stock-cli graph theme-winners "AI"
자동화 (cron) — 본인이 손 안 대도 도는 것들
| 시각 (KST) | 작업 | 무엇이 일어남 |
|---|
| 평일 07:00 | KR daily_briefing | Telegram에 KR 시장 요약 + 1-3 예측 등록 |
| 평일 21:00 | US daily_briefing | Telegram에 US 시장 요약 + 1-3 예측 등록 |
| 매일 00:00 | outcome_tracker | OPEN 예측 평가 → HIT/MISS/EXPIRED, Telegram 알림 |
| 일요일 22:00 | weekly_calibration | reports/weekly-calibration-*.md 생성, 12주 트렌드 갱신 |
설정 상세: cron_setting.md. 변경: crontab -e. 끄기: crontab -r.
수동 실행:
uv run python scheduler/daily_briefing.py --market KR
uv run python scheduler/outcome_tracker.py
uv run python scheduler/weekly_calibration.py
시나리오별 권장 흐름
A. 매일 5분 워크플로
- 자동 cron이 07:00/21:00 Telegram briefing 발송 → 읽기
- 출근/퇴근길에
/prediction-review로 적중률 확인
- 관심 종목 떠오르면
/expect <ticker>
B. 새로운 종목 발굴 (다양성 ↑)
/vcp-screener 또는 /canslim-screener로 후보 30~50개- 좁혀서 5개 →
/expect TICKER1,TICKER2,...로 점수화
- BUY 라벨 받으면
/position-sizer로 매수 수량 계산
C. 매수 직전 매크로 점검
/macro-regime-detector — 어느 레짐?/market-top-detector — 천장 신호 있는가?/ftd-detector — 바닥 확인됐는가?- 시장 환경 OK → 매수 진행
D. 주간 회고 (일요일 저녁)
- 자동 weekly_calibration이 22:00에 리포트 생성
reports/weekly-calibration-YYYY-MM-DD.md 읽기/prediction-review로 어떤 시그널이 잘 작동했는지 확인- 다음 주 가중치 조정
E. 포트폴리오 관리
/toss-sync로 토스 증권 동기화 (또는 수동 portfolio buy/sell)/portfolio-eval로 4축 분석- 추천 받으면
/expect로 추가 매수 후보 검증
학습 자료 (더 깊이 알고 싶을 때)
| 파일 | 내용 |
|---|
README.md | 시스템 전체 개요 + 설치 + 시나리오 |
cron_setting.md | 자동화 스케줄 설정 / 로그 / 트러블슈팅 |
docs/HANDOFF.md | 스테이지별 변경 이력 + 결정 포인트 |
.claude/skills/expect/SKILL.md | /expect 점수 테이블 (ALGO_SCORE/NEWS_SCORE) 전체 |
docs/stage-{1..7,4.1}/*.md | 단계별 설계 결정 + 회고 |
도움이 되지 않을 때
- 특정 ticker 정보가 안 나옴 →
bin/stock-cli health로 provider 상태 확인
- skill이 트리거 안 됨 →
/명령어 직접 호출 또는 description의 키워드 사용
- 자동 cron이 안 도는 것 같음 →
tail ~/logs/stock-expectation/*.log
- 새 환경에서 처음 셋업 →
README.md "설치" 섹션 참조 (uv sync → .env.example 복사 → 키 입력)
질문 형식 자유. "어떻게 ~ 하지?" / "~ 명령어 뭐였더라?" / "내가 마지막 한 거 보여줘" 같은 자연어 모두 OK.
