Skene

   

Skene आपके कोडबेस को पढ़ता है और आपके उत्पाद के लिए एक उपयोगकर्ता यात्रा तैयार करता है: जीवनचक्र के चरण जिनसे एक उपयोगकर्ता गुजरता है, प्रत्येक चरण के भीतर के मील के पत्थर, और कोड या डेटाबेस साक्ष्य जो साबित करते हैं कि प्रत्येक मील का पत्थर वास्तविक है।

त्वरित आरंभ

इंटरैक्टिव टर्मिनल UI स्थापित करें और लॉन्च करें:

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

विज़ार्ड आपको प्रदाता चयन, प्रमाणीकरण और विश्लेषण के माध्यम से मार्गदर्शन करता है — पहले से किसी कॉन्फ़िगरेशन की आवश्यकता नहीं है।

यह क्या करता है

Skene एक रिपॉजिटरी को आपके उत्पाद के उपयोगकर्ता जीवनचक्र का वर्णन करने वाले एकल journey.yaml में बदल देता है, और इसे एक इंटरैक्टिव आरेख के रूप में प्रस्तुत करता है।

• एजेंटिक विश्लेषण — दो समानांतर एजेंट आपके प्रोजेक्ट को पढ़ते हैं: एक कोडबेस का विश्लेषण करता है, एक आपके SQL स्कीमा का। वे प्रत्येक उम्मीदवार मील के पत्थर प्रस्तावित करते हैं, जिन्हें फिर विलय कर एक विहित सात-चरणीय जीवनचक्र में वर्गीकृत किया जाता है।
• सात-चरणीय उपयोगकर्ता यात्रा — हर उत्पाद समान विहित चरणों (खोज, ऑनबोर्डिंग, सक्रियण, जुड़ाव, प्रतिधारण, विस्तार, वायरलिटी) में मैप होता है ताकि यात्राएँ उत्पादों के बीच तुलनीय हों। चरणों के नाम आपके उत्पाद के अनुसार विशेषीकृत किए जाते हैं जहाँ उपयोगी हो।
• साक्ष्य-समर्थित मील के पत्थर — प्रत्येक मील का पत्थर एक 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/) एक Bubble Tea ऐप है जो एक इंटरैक्टिव विज़ार्ड अनुभव प्रदान करता है और uvx के माध्यम से Python CLI को ऑर्केस्ट्रेट करता है। प्रत्येक पैकेज में स्वतंत्र CI/CD पाइपलाइन हैं।

योगदान

योगदान का स्वागत है। कृपया एक मुद्दा खोलें या पुल अनुरोध सबमिट करें।

लाइसेंस

MIT