MobiusQuant/OpenMobius-skill

ICT/SMC trading-knowledge skill for AI coding agents (Claude Code / Codex / OpenClaw / Hermes)

OpenMobius‑skill – AI 코딩 에이전트용 트레이딩 지식 스킬

개요 – 여러 AI 코딩 에이전트(Claude Code, Codex, OpenClaw, Hermes, Cursor, WorkBuddy)에 설치할 수 있는 스킬(플러그인)입니다. 설치 후 에이전트는 트레이딩 관련 질문에 답하고, 실시간 시장 데이터를 가져오고, 60개 이상의 기술적 지표를 계산하고, 주석이 달린 차트를 생성할 수 있습니다. 지식 베이스에는 ICT, SMC, 찬룬, 위코프 등에서 약 2,000개의 엄선된 "지식 카드"와 18,645개의 소스 수준 증거 레코드가 포함되어 있습니다.

주요 기능

멀티스쿨 지식 – 14개 이상의 트레이딩 "스쿨" (ICT, SMC, 찬룬, 프라이스 액션, 엘리엇 웨이브 등)을 엄격한 범위로 지정하여 에이전트가 선택한 방법론만 사용하도록 합니다.
실시간 시장 데이터 – 암호화폐(Binance, Bybit, OKX, Hyperliquid), 미국/중국 주식, 외환을 지원합니다. 데이터는 현재 턴에 온디맨드로 가져옵니다.
기술적 지표 – 60개 이상의 내장 지표. 에이전트는 추가 페치 없이 특정 자산에 대한 특정 지표를 반환할 수 있습니다.
차트 생성 – 두 가지 경로: (1) Pillow를 사용하여 사용자 제공 이미지에 주석을 달기, (2) Playwright를 통해 헤드리스 Chromium에서 렌더링된 lightweight-charts로 새 차트 생성.
의도 및 분석 라우팅 – 스킬은 먼저 사용자 의도(Q&A, 차트 분석, 주석, K-라인 분석)를 분류한 다음 시장 데이터를 가져올 수 있는지 결정하기 전에 렌즈(방법론)와 스쿨을 해결합니다. 지원되지 않는 경로는 명시적 설명과 함께 페일 클로즈됩니다.
구성 모드 – strict(선택한 스쿨만 사용), augment(기본 + 지원 스쿨), compare(두 스쿨의 나란히 Q&A).
자체 포함 설치 – 각 플랫폼은 자체 가상 환경, 인덱스, 캐시된 모델 가중치(nomic-embed-text-v1.5) 및 Chromium 바이너리를 얻습니다.
플랫폼 지원 – Claude Code, Codex, OpenClaw(Linux/macOS), Hermes(Linux/macOS), Cursor, WorkBuddy(ZIP 가져오기).

설치 방법

# 임시 위치에 리포지토리 클론
OPENMOBIUS_SRC=$(mktemp -d)
git clone https://github.com/MobiusQuant/OpenMobius-skill.git $OPENMOBIUS_SRC
cd $OPENMOBIUS_SRC
# 대상 에이전트 선택 (예: Claude Code)
python3 install.py --platform claude-code   # 또는 codex, openclaw, hermes, cursor, workbuddy

설치 프로그램은:

스킬 파일을 에이전트의 스킬 디렉토리(예: ~/.claude/skills/openmobius-skill/)에 복사합니다.
전용 .venv를 만들고 Python 종속성을 설치합니다.
Playwright Chromium(약 280MiB) 및 nomic 임베딩 모델(약 547MiB)을 다운로드합니다.
릴리스된 시드를 사용하여 로컬 벡터 인덱스를 구축합니다. 누락된 문서만 첫 실행 시 임베딩됩니다.
플랫폼별 SKILL.md를 생성하고 상태 점검을 실행합니다.

후속 실행은 캐시된 모델과 인덱스를 재사용하므로 대용량 다운로드가 필요한 것은 첫 설치뿐입니다.

일반적인 사용법(설치 후)

"What is Liquidity Sweep?"                     # 지식 Q&A, 엄격한 ICT/SMC
"How is ETH 4h looking?"                      # 실시간 시장 분석, 차트 출력
"Explain 中枢 using ChanLun only"               # 찬룬 스쿨로 제한된 Q&A
"Compare ICT and ChanLun definitions of market structure"  # 비교 모드, Q&A만
"Generate a chart with my entry/SL/target"    # Playwright를 통한 차트 생성
"Paste a CSV of OHLCV"                         # 로컬 K-라인 분석, 실시간 데이터 없음

스킬은 인용이 포함된 근거 기반 답변 및/또는 PNG 차트를 반환하거나, 요청된 기능을 사용할 수 없다고 명시적으로 설명합니다(예: 라이브 분석에 비네이티브 스쿨을 사용하려는 경우).

로드맵 하이라이트

ICT 하위 스쿨 범위 완료(Inner Circle Mentorship, Silver Bullet, Power-of-3 변형).
ICT/SMC 외 추가 스쿨용 네이티브 분석기 추가.
지식 베이스 확장(더 많은 개념, 사례, 소스 증거).
의미 검색 옵션 개선 및 순수 어휘 폴백 제공.

라이선스 및 커뮤니티

Apache 2.0 라이선스.
사용자 지원을 위한 Discord 및 Telegram 채널.
문서에는 README_AGENT.md(에이전트용 설치 단계), INSTALL.md, 상세 워크플로 사양이 포함됩니다.

OpenMobius‑skill은 AI 코딩 에이전트에 구조화된 멀티스쿨 트레이딩 지식 베이스와 실시간 시장 분석 기능을 제공하는 진정한 설치 가능한 소프트웨어 구성 요소입니다.