Skene MCP Server
공식Skene는 제품 주도 성장을 위한 코드베이스 분석 툴킷입니다. 코드베이스를 스캔하여 성장 기회를 탐지하고 실행 가능한 구현 계획을 생성합니다.
문서
Skene은 코드베이스를 읽고 제품의 사용자 여정을 생성합니다. 사용자가 거치는 생애 주기 단계, 각 단계 내의 마일스톤, 그리고 각 마일스톤이 실제임을 증명하는 코드 또는 데이터베이스 증거를 보여줍니다.
빠른 시작
대화형 터미널 UI를 설치하고 실행하세요:
curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
skene
마법사가 제공자 선택, 인증, 분석 과정을 안내하므로 사전 설정이 필요 없습니다.
기능
Skene은 저장소를 제품의 사용자 생애 주기를 설명하는 하나의 journey.yaml로 변환하고, 이를 대화형 다이어그램으로 렌더링합니다.
- 에이전트 기반 분석 — 두 개의 병렬 에이전트가 프로젝트를 읽습니다. 하나는 코드베이스를, 다른 하나는 SQL 스키마를 분석합니다. 각 에이전트는 후보 마일스톤을 제안하고, 이를 병합하여 표준 7단계 생애 주기로 분류합니다.
- 7단계 사용자 여정 — 모든 제품은 동일한 표준 단계(발견, 온보딩, 활성화, 참여, 유지, 확장, 바이럴리티)로 매핑되므로, 제품 간 여정을 비교할 수 있습니다. 단계 이름은 필요에 따라 제품에 맞게 특화됩니다.
- 증거 기반 마일스톤 — 각 마일스톤은
tracked_event,confidence점수, 그리고 해당 마일스톤을 정당화하는 정확한 코드 경로, 데이터베이스 테이블, 또는 설정 파일을 가리키는 하나 이상의evidence칩을 포함합니다. - 여정 시각화 도구 — TUI는 로컬 웹 앱을 열어 단계를 열로 배치하고, 마일스톤 카드와 클릭 가능한 증거 칩을 표시하여 기본 소스와 함께 여정을 검토할 수 있게 합니다.
- 코드 전용, 스키마 전용, 또는 둘 다 — 코드베이스만,
*.sql파일 디렉터리만, 또는 더 풍부한 증거를 위해 둘 다를 대상으로 실행할 수 있습니다.
OpenAI, Gemini, Claude, LM Studio, Ollama 및 모든 OpenAI 호환 엔드포인트를 지원합니다.
설치
터미널 UI (권장)
TUI는 전체 워크플로를 안내하는 대화형 마법사입니다. 사전 요구 사항이 없으며 설치 프로그램이 모든 것을 처리합니다.
# Install the TUI
curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
# Launch it
skene
Python CLI
명령줄을 선호하는 경우, uvx로 직접 실행하거나(설치 불필요) 전역으로 설치할 수 있습니다:
# Install uv (if you don't have it)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Run directly (no install needed)
uvx skene analyse-journey .
# Or install globally
pip install skene
skene analyse-journey .
유용한 플래그:
--schema-dir <dir>— 내보낸*.sql파일 디렉터리를 지정하여 스키마 에이전트를 활성화합니다-o <path>— 출력 파일을 재정의합니다 (기본값./skene-context/journey.yaml)--no-specialize— LLM이 단계 이름을 특화하지 않고 표준 단계 이름을 유지합니다
전체 CLI 사용법은 문서를 참조하세요.
출력 레이아웃
Python CLI와 TUI 모두 프로젝트 루트의 단일 번들 디렉터리에 아티팩트를 기록하며, 디렉터리가 없으면 자동으로 생성됩니다.
- 기본값:
./skene-context/journey.yaml— 제품에 대해 분석된 사용자 여정입니다. - 재정의:
.skene.config에서output_dir를 설정하거나-o/--output를 전달하여 다른 위치에 기록합니다.
모노레포 구조
| 디렉터리 | 설명 | 언어 | 배포 |
|---|---|---|---|
src/skene/ | CLI + 분석 엔진 | Python | PyPI |
tui/ | 대화형 터미널 UI 마법사 | Go | GitHub Releases |
cursor-plugin/ | Cursor IDE 플러그인 | — | — |
skills/ | Skene Skills — Supabase용 구성 가능한 백엔드 스키마 | SQL | npm |
TUI(tui/)는 Bubble Tea 앱으로, 대화형 마법사 경험을 제공하며 uvx를 통해 Python CLI를 조정합니다. 각 패키지는 독립적인 CI/CD 파이프라인을 갖습니다.
기여
기여를 환영합니다. 이슈를 열거나 풀 리퀘스트를 제출해 주세요.