Menu
KIS 환경을 진단하거나 설치할 때 반드시 사용. '환경 확인', '설치해줘', 'setup', 'kis-setup'이라고 할 때 자동 실행된다.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | kis-setup |
| description | KIS 환경을 진단하거나 설치할 때 반드시 사용. '환경 확인', '설치해줘', 'setup', 'kis-setup'이라고 할 때 자동 실행된다. |
uv run <프로젝트루트>/.codex/scripts/setup_check.py <프로젝트루트>| 입력 | 동작 |
|---|---|
| (인자 없음) | 전체 진단 + 실패 항목 순서대로 수정 |
check, status, 상태 | 진단만 수행, 수정 없음 |
p1 | P1만 설치 (uv sync + pnpm install) |
p2 | P2만 설치 (uv sync + pnpm install + lean) |
lean | Lean 환경만 설정 |
mcp | MCP 서버 시작만 |
setup_check.py <프로젝트루트> 실행 후 상태 표로 출력.
all_ok가 true면 "모든 설정이 완료되었습니다!"라고 안내 후 종료.
| 항목 | 안내 |
|---|---|
| Python | brew install python@3.11 또는 공식 사이트 |
| uv | curl -LsSf https://astral.sh/uv/install.sh | sh |
| Node.js | brew install node 또는 nvm |
| Docker 미설치 | docker.com/products/docker-desktop |
| Docker 미실행 | "Docker Desktop을 시작해주세요" 안내 후 대기 |
~/KIS/config/kis_devlp.yaml 없으면 아래 템플릿 안내:
my_app: "실전투자 앱키"
my_sec: "실전투자 앱시크릿"
paper_app: "모의투자 앱키"
paper_sec: "모의투자 앱시크릿"
my_htsid: "HTS ID"
my_acct_stock: "증권계좌 8자리"
my_paper_stock: "모의투자 증권계좌 8자리"
my_prod: "01"
절대로 config 파일을 직접 읽거나 쓰지 않는다.
cd strategy_builder && uv sync + cd frontend && pnpm install + .env.local 없으면 생성:
cp strategy_builder/frontend/.env.example strategy_builder/frontend/.env.local
⚠️ 호가창 WebSocket(실시간 호가)을 사용하려면
.env.local의NEXT_PUBLIC_API_URL=http://localhost:8000설정이 필수입니다.
cd backtester && uv sync + cd frontend && pnpm installbash backtester/scripts/setup_lean_data.shbash backtester/scripts/start_mcp.sh 백그라운드 실행 후 http://127.0.0.1:3846/health 확인.
"모의투자로 시작하려면 '인증해줘 vps'를 입력하세요."
kis_devlp.yaml을 직접 읽거나 쓰지 않는다.KIS 인증이 필요할 때 반드시 사용. '인증해줘', '모의투자 인증', '실전 인증', '토큰 갱신', 'auth vps', 'auth prod', 'auth switch'라고 할 때 자동 실행된다.
KIS 플러그인 사용법을 안내할 때 사용. '사용법', '도움말', '커맨드 목록', '오류코드', 'kis-help'라고 할 때 자동 실행된다.
KIS 계좌 상태를 조회할 때 반드시 사용. '잔고 확인', '보유종목', '내 계좌', '지수 확인', 'my-status'라고 할 때 자동 실행된다.
KIS 전략을 과거 데이터로 검증하거나 성과를 확인할 때 반드시 사용. '백테스팅', '백테스트 해줘', '전략 검증', '성과 분석', '파라미터 최적화', '수익률 확인', '과거 검증', '샤프 확인', '최대낙폭 보고 싶어', '이 전략 수익률이 어떻게 돼?'라고 할 때 자동 실행된다. backtester MCP 서버를 통해 10개 프리셋(sma_crossover, momentum 등) 또는 .kis.yaml 전략 실행, BacktestResult(총수익률·CAGR·최대낙폭·샤프) 해석, Grid/Random 파라미터 최적화, 배치 전략 비교, 포트폴리오 분석, HTML 리포트 생성을 수행한다.
Handle KIS customer-service style support. Use when users are confused, report errors, ask unsupported/illegal requests, request direct stock picks, or need policy-safe alternatives.
KIS 전략의 실시간 신호를 확인하거나 주문을 실행할 때 반드시 사용. '전략 실행해줘', '신호 확인', '종목 돌려봐줘', '매수 신호 있어?', '매도 타이밍', '실시간 매매', '자동매매', '삼성전자 지금 들어가도 돼?', '이 전략으로 주문 넣어줘'라고 할 때 자동 실행된다. 종목 코드를 먼저 선택한 뒤 전략을 실행해 BUY·SELL·HOLD 신호와 강도(0~1)를 확인하고, 신호 강도에 따라 모의(vps)/실전(prod) 주문을 실행한다. 실전투자 주문 전 반드시 사용자 확인을 받는다.