financial-harnesslisted
Install: claude install-skill twiw49/financial-harness
# Financial Harness (MCP loader v3)
**방법론·데이터는 런타임에 `mcp__hyean__*` 툴이 제공한다.** 이 파일은 스코프 게이트, 런 격리,
페이즈 시퀀스, 파일 규율만 담당하는 얇은 로더다. (구 v2 git-clone 방식의 agents/·references/는
서버로 이관 — `get_plan`이 매 런 최신 방법론을 내려준다.)
## 0. 스코프 게이트 (요청 수신 직후 — 그 무엇보다 먼저, MCP 호출 전에)
이 하네스는 **한국 상장기업 주식·재무 분석 전용**이다. 범위 밖(스포츠·일반상식·코딩·외국기업만)이면 **어떤 툴도 부르기 전에 멈추고**:
1. 파이프라인 강제 진행 금지 (크레딧·시간 낭비 + 헛 보고서)
2. 정직하게 범위 밖 고지 — 날조·추측 금지
3. 적합한 도구 안내 (다출처 리서치는 /deep-research 등). 금융 각도가 실재하면 재해석 제안
4. 경계가 모호하면 1줄로 의도 확인
**커버리지 경계 (스코프 안이어도 먼저 ��지):** ① 금융업(은행·보험·증권·금융지주) = 재무제표 미지원 — 지배구조·공시·주가·뉴스만 ② 자유 백테스트(시점별 유니버스·팩터 패널) = 미지원, `/prices/bulk`(≤50종목) 가격 규칙 검증만 ③ 실시간(장중 시세·호가) = 미지원, prices=일별 EOD.
## 0.5 명확화 게이트 (모호한 요청에만)
스코프 안인데 분석 방향이 갈리면 `AskUserQuestion` **1회**(질문 2~3개 이하, 첫 옵션에 "(권장)")로 확정. 명확하면 즉시 진행 · 합리적 기본값(기준일=오늘, consol=1, 보고서 1편)은 묻지 않고 가정 1줄 명시.
## 1. MCP 연결 확인 · 온보딩 self-heal
`mcp__hyean__preflight` 툴이 **보이지 않으면** STOP하고 안내:
```
claude mcp add --transport http hyean https://api.hyean.io/mcp
(Claude Code 재시작 후) /mcp → hyean → 브라우저에서 로그인·승인
```
CI/헤드리스: `claude mcp add --transport http hyean https://api.hyean.io/mcp --header "Authorization: Bearer $HYEAN_API_KEY"`
로컬 API 개발: 위 URL을 `http://localhost:8000/mcp`로 바꾼 `hyean-dev` 항목 별도 등록.
**버전 게이트**: `HARNESS_VERSION`(이 폴더) < `preflight.min_loader_version` �� "이 폴더에서 git pull" 안내 후 진행. 로컬 design-kit 해시 ≠ `preflight.kit_sha256`이면 같은 안내(경고성, 차단 아님).
## 2. 실행 시퀀스
1. **preflight** — `mcp__hyean__preflight` 1콜: 크레딧 잔량(<30이면 §0 경계 규약대로 사용자 경고)·api