Skene
공식Skene는 제품 주도 성장을 위한 코드베이스 분석 툴킷입니다. 코드베이스를 스캔하여 성장 기회를 탐지하고 실행 가능한 구현 계획을 생성합니다.
Skene MCP(으)로 무엇을 할 수 있나요?
- 코드베이스를 사용자 여정으로 분석 — AI에게 저장소에서
analyse-journey를 실행하도록 요청하여 수명 주기 단계, 이정표, 증거를 매핑한journey.yaml을 생성하게 하세요. - 코드 및 SQL 스키마 분석 결합 —
--schema-dir옵션을 사용하여 Skene을*.sql파일 디렉토리로 지정하면 각 이정표를 코드와 데이터베이스 증거로 모두 뒷받침할 수 있습니다. - 여정 출력 사용자 지정 —
-o를 사용하여 생성된journey.yaml을 특정 경로로 리디렉션하거나,--no-specialize를 사용하여 제품별 이름 대신 표준 단계 이름을 유지하세요. - 대화형 설정 마법사 시작 — AI가
skeneTUI 설치 및 실행을 안내하도록 하여, 공급자 선택과 인증을 대화형으로 처리하게 하세요.
문서
Skene는 코드베이스를 읽고 제품에 대한 사용자 여정(user journey) 을 생성합니다: 사용자가 거치는 수명 주기 단계, 각 단계 내의 이정표, 그리고 각 이정표가 실제로 존재함을 입증하는 코드 또는 데이터베이스 증거를 제공합니다.
빠른 시작
대화형 터미널 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 (설치 불필요)로 Skene를 직접 실행하거나 전역으로 설치할 수 있습니다:
# 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 플러그인 | — | — |
TUI(tui/)는 대화형 마법사 경험을 제공하고 uvx를 통해 Python CLI를 오케스트레이션하는 Bubble Tea 앱입니다. 각 패키지에는 독립적인 CI/CD 파이프라인이 있습니다.
기여
기여를 환영합니다. 이슈를 열거나 풀 리퀘스트를 제출해 주세요.