Skene

   

Skene kod tabanınızı okur ve ürününüz için bir kullanıcı yolculuğu üretir: kullanıcının geçtiği yaşam döngüsü aşamaları, her aşamanın içindeki kilometre taşları ve her kilometre taşının gerçek olduğunu kanıtlayan kod veya veritabanı kanıtları.

Hızlı Başlangıç

Etkileşimli terminal arayüzünü kurun ve başlatın:

curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
skene

Sihirbaz sizi sağlayıcı seçimi, kimlik doğrulama ve analiz boyunca yönlendirir — önceden yapılandırma gerekmez.

Ne Yapar

Skene bir depoyu, ürününüzün kullanıcı yaşam döngüsünü tanımlayan tek bir journey.yaml dosyasına dönüştürür ve bunu etkileşimli bir diyagram olarak işler.

• Aracı tabanlı analiz — iki paralel aracı projenizi okur: biri kod tabanını, diğeri SQL şemalarınızı inceler. Her biri aday kilometre taşları önerir; bunlar daha sonra birleştirilir ve kanonik yedi aşamalı bir yaşam döngüsüne sınıflandırılır.
• Yedi aşamalı kullanıcı yolculuğu — her ürün aynı kanonik aşamalara (keşif, kayıt, aktivasyon, etkileşim, elde tutma, genişleme, virallik) eşlenir; böylece yolculuklar ürünler arasında karşılaştırılabilir. Aşama adları, gerektiğinde ürününüze özel olarak uyarlanır.
• Kanıt destekli kilometre taşları — her kilometre taşı bir tracked_event, bir confidence puanı ve onu haklı çıkaran tam kod yoluna, veritabanı tablosuna veya yapılandırma dosyasına işaret eden bir veya daha fazla evidence rozeti taşır.
• Yolculuk görselleştirici — TUI, aşamaları sütunlar halinde düzenleyen, kilometre taşı kartları ve tıklanabilir kanıt rozetleri içeren yerel bir web uygulaması açar; böylece yolculuğu temel kaynakla birlikte inceleyebilirsiniz.
• Yalnızca kod, yalnızca şema veya her ikisi — yalnızca bir kod tabanına, yalnızca bir *.sql dosya dizinine veya daha zengin kanıt için her ikisine karşı çalıştırın.

OpenAI, Gemini, Claude, LM Studio, Ollama ve OpenAI uyumlu herhangi bir uç noktayı destekler.

Kurulum

Terminal Arayüzü (önerilir)

TUI, tüm iş akışı boyunca size rehberlik eden etkileşimli bir sihirbazdır. Ön koşul yok — yükleyici her şeyi halleder.

# Install the TUI
curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash

# Launch it
skene

Python CLI

Komut satırını tercih ederseniz, Skene'i doğrudan uvx ile çalıştırabilirsiniz (kurulum gerekmez) veya global olarak kurabilirsiniz:

# 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 .

Yararlı bayraklar:

• --schema-dir <dir> — şema aracısını etkinleştirmek için dışa aktarılmış *.sql dosyalarının bulunduğu bir dizini işaret edin
• -o <path> — çıktı dosyasını geçersiz kılın (varsayılan ./skene-context/journey.yaml)
• --no-specialize — LLM'in bunları özelleştirmesine izin vermek yerine kanonik aşama adlarını koruyun

Tam CLI kullanımı için dokümantasyona bakın.

Çıktı Düzeni

Hem Python CLI hem de TUI, yoksa otomatik olarak oluşturulan proje kökünüzdeki tek bir paket dizinine yapıtlar yazar.

• Varsayılan: ./skene-context/journey.yaml — ürününüz için analiz edilen kullanıcı yolculuğu.
• Geçersiz kılma: .skene.config içinde output_dir ayarlayın veya başka bir yere yazmak için -o/--output geçirin.

Monorepo Yapısı

Dizin	Açıklama	Dil	Dağıtım
src/skene/	CLI + analiz motoru	Python	PyPI
tui/	Etkileşimli terminal arayüzü sihirbazı	Go	GitHub Releases
cursor-plugin/	Cursor IDE eklentisi	—	—

TUI (tui/), etkileşimli bir sihirbaz deneyimi sağlayan ve Python CLI'yi uvx aracılığıyla düzenleyen bir Bubble Tea uygulamasıdır. Her paketin bağımsız CI/CD boru hatları vardır.

Katkıda Bulunma

Katkılar memnuniyetle karşılanır. Lütfen bir sorun açın veya bir çekme isteği gönderin.

Lisans

MIT