Skene

   

Skene membaca basis kode Anda dan menghasilkan perjalanan pengguna untuk produk Anda: tahapan siklus hidup yang dilalui pengguna, tonggak pencapaian di dalam setiap tahapan, serta bukti kode atau basis data yang membuktikan setiap tonggak tersebut nyata.

Memulai dengan Cepat

Instal dan jalankan antarmuka terminal interaktif:

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

Wizard akan memandu Anda melalui pemilihan penyedia, autentikasi, dan analisis — tanpa perlu konfigurasi di awal.

Apa yang Dilakukannya

Skene mengubah repositori menjadi satu journey.yaml yang mendeskripsikan siklus hidup pengguna produk Anda, lalu menampilkannya sebagai diagram interaktif.

• Analisis agen — dua agen paralel membaca proyek Anda: satu menelusuri basis kode, satu menelusuri skema SQL Anda. Masing-masing mengusulkan kandidat tonggak pencapaian, yang kemudian digabungkan dan diklasifikasikan ke dalam siklus hidup kanonik tujuh tahap.
• Perjalanan pengguna tujuh tahap — setiap produk dipetakan ke tahapan kanonik yang sama (penemuan, orientasi, aktivasi, keterlibatan, retensi, ekspansi, viralitas) sehingga perjalanan dapat dibandingkan antar produk. Nama tahapan disesuaikan dengan produk Anda jika diperlukan.
• Tonggak berbasis bukti — setiap tonggak membawa tracked_event, skor confidence, dan satu atau lebih chip evidence yang menunjuk kembali ke jalur kode, tabel basis data, atau file konfigurasi yang mendukungnya.
• Visualisasi perjalanan — TUI membuka aplikasi web lokal yang menyusun tahapan sebagai kolom, dengan kartu tonggak dan chip bukti yang dapat diklik, sehingga Anda dapat meninjau perjalanan bersama dengan sumber yang mendasarinya.
• Hanya kode, hanya skema, atau keduanya — jalankan hanya pada basis kode, hanya pada direktori file *.sql, atau keduanya untuk bukti yang lebih kaya.

Mendukung OpenAI, Gemini, Claude, LM Studio, Ollama, dan endpoint apa pun yang kompatibel dengan OpenAI.

Instalasi

Antarmuka Terminal (disarankan)

TUI adalah wizard interaktif yang memandu Anda melalui seluruh alur kerja. Tanpa prasyarat — penginstal menangani semuanya.

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

# Launch it
skene

CLI Python

Jika Anda lebih suka baris perintah, Anda dapat menjalankan Skene langsung dengan uvx (tanpa perlu instalasi) atau menginstalnya secara global:

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

Flag yang berguna:

• --schema-dir <dir> — arahkan ke direktori file *.sql yang diekspor untuk mengaktifkan agen skema
• -o <path> — ganti file keluaran (default ./skene-context/journey.yaml)
• --no-specialize — pertahankan nama tahapan kanonik alih-alih membiarkan LLM menyesuaikannya

Untuk penggunaan CLI lengkap, lihat dokumentasi.

Tata Letak Keluaran

Baik CLI Python maupun TUI menulis artefak ke satu direktori bundel di akar proyek Anda, yang dibuat otomatis jika tidak ada.

• Default: ./skene-context/journey.yaml — perjalanan pengguna yang dianalisis untuk produk Anda.
• Ganti: atur output_dir di .skene.config atau berikan -o/--output untuk menulis di tempat lain.

Struktur Monorepo

Direktori	Deskripsi	Bahasa	Distribusi
src/skene/	CLI + mesin analisis	Python	PyPI
tui/	Wizard antarmuka terminal interaktif	Go	GitHub Releases
cursor-plugin/	Plugin IDE Cursor	—	—

TUI (tui/) adalah aplikasi Bubble Tea yang menyediakan pengalaman wizard interaktif dan mengorkestrasi CLI Python melalui uvx. Setiap paket memiliki pipeline CI/CD independen.

Kontribusi

Kontribusi sangat diterima. Silakan buka masalah atau kirim pull request.

Lisensi

MIT