Skene

   

Skene đọc mã nguồn của bạn và tạo ra một hành trình người dùng cho sản phẩm của bạn: các giai đoạn vòng đời mà người dùng trải qua, các mốc quan trọng trong từng giai đoạn, và bằng chứng từ mã hoặc cơ sở dữ liệu chứng minh mỗi mốc là có thật.

Bắt đầu nhanh

Cài đặt và khởi chạy giao diện terminal tương tác:

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

Trình hướng dẫn sẽ đưa bạn qua các bước chọn nhà cung cấp, xác thực và phân tích — không cần cấu hình trước.

Chức năng

Skene biến một kho lưu trữ thành một journey.yaml duy nhất mô tả vòng đời người dùng của sản phẩm, và hiển thị nó dưới dạng sơ đồ tương tác.

• Phân tích tác nhân — hai tác nhân song song đọc dự án của bạn: một tác nhân duyệt mã nguồn, một tác nhân duyệt các lược đồ SQL. Mỗi tác nhân đề xuất các mốc tiềm năng, sau đó được hợp nhất và phân loại thành một vòng đời bảy giai đoạn chuẩn.
• Hành trình người dùng bảy giai đoạn — mọi sản phẩm đều ánh xạ đến cùng các giai đoạn chuẩn (khám phá, đăng ký, kích hoạt, tương tác, giữ chân, mở rộng, lan truyền) để các hành trình có thể so sánh giữa các sản phẩm. Tên giai đoạn được chuyên biệt hóa cho sản phẩm của bạn khi cần thiết.
• Mốc có bằng chứng — mỗi mốc mang một tracked_event, điểm confidence, và một hoặc nhiều chip evidence trỏ ngược về đường dẫn mã chính xác, bảng cơ sở dữ liệu, hoặc tệp cấu hình chứng minh cho mốc đó.
• Trình trực quan hóa hành trình — TUI mở một ứng dụng web cục bộ bố trí các giai đoạn thành các cột, với thẻ mốc và chip bằng chứng có thể nhấp, để bạn xem lại hành trình cùng với mã nguồn bên dưới.
• Chỉ mã, chỉ lược đồ, hoặc cả hai — chạy chỉ với mã nguồn, chỉ với thư mục tệp *.sql, hoặc cả hai để có bằng chứng phong phú hơn.

Hỗ trợ OpenAI, Gemini, Claude, LM Studio, Ollama, và mọi endpoint tương thích OpenAI.

Cài đặt

Giao diện terminal (khuyến nghị)

TUI là một trình hướng dẫn tương tác đưa bạn qua toàn bộ quy trình làm việc. Không cần điều kiện tiên quyết — trình cài đặt xử lý mọi thứ.

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

# Launch it
skene

CLI Python

Nếu bạn thích dòng lệnh, bạn có thể chạy Skene trực tiếp với uvx (không cần cài đặt) hoặc cài đặt toàn cục:

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

Các cờ hữu ích:

• --schema-dir <dir> — trỏ đến thư mục chứa các tệp *.sql đã xuất để kích hoạt tác nhân lược đồ
• -o <path> — ghi đè tệp đầu ra (mặc định ./skene-context/journey.yaml)
• --no-specialize — giữ nguyên tên giai đoạn chuẩn thay vì để LLM chuyên biệt hóa chúng

Để biết cách sử dụng CLI đầy đủ, xem tài liệu.

Bố cục đầu ra

Cả CLI Python và TUI đều ghi các tạo phẩm vào một thư mục bundle duy nhất trong thư mục gốc dự án của bạn, được tạo tự động nếu chưa có.

• Mặc định: ./skene-context/journey.yaml — hành trình người dùng đã phân tích cho sản phẩm của bạn.
• Ghi đè: đặt output_dir trong .skene.config hoặc truyền -o/--output để ghi ở nơi khác.

Cấu trúc Monorepo

Thư mục	Mô tả	Ngôn ngữ	Phân phối
src/skene/	CLI + công cụ phân tích	Python	PyPI
tui/	Trình hướng dẫn giao diện terminal tương tác	Go	GitHub Releases
cursor-plugin/	Plugin IDE Cursor	—	—

TUI (tui/) là một ứng dụng Bubble Tea cung cấp trải nghiệm trình hướng dẫn tương tác và điều phối CLI Python qua uvx. Mỗi gói có các pipeline CI/CD độc lập.

Đóng góp

Rất hoan nghênh các đóng góp. Vui lòng mở issue hoặc gửi pull request.

Giấy phép

MIT