Skene MCP Server

   

Skene đọc cơ sở mã của bạn và tạo ra một hành trình người dùng cho sản phẩm: các giai đoạn vòng đời mà người dùng trải qua, các cột mốc trong mỗi giai đoạn, và bằng chứng từ mã hoặc cơ sở dữ liệu chứng minh mỗi cột 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 cơ sở mã, một tác nhân duyệt các lược đồ SQL. Chúng đề xuất các cột mốc ứng viên, sau đó được hợp nhất và phân loại vào 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ạ vào cùng các giai đoạn chuẩn (khám phá, giới thiệu, 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 được 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 hữu ích.
• Cột mốc có bằng chứng — mỗi cột mốc mang một tracked_event, một điểm confidence, và một hoặc nhiều chip evidence trỏ ngược lại đường dẫn mã, bảng cơ sở dữ liệu, hoặc tệp cấu hình chính xác đã chứng minh nó.
• Trình trực quan 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 các thẻ cột mốc và chip bằng chứng có thể nhấp, để bạn có thể xem lại hành trình cùng với mã nguồn cơ sở.
• Chỉ mã, chỉ lược đồ, hoặc cả hai — chạy chỉ với cơ sở mã, chỉ với thư mục chứa 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à bất kỳ điểm cuối tương thích OpenAI nào.

Cài Đặt

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

TUI là một trình hướng dẫn tương tác dẫn 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

Python CLI

Nếu bạn thích dòng lệnh hơn, 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 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ữ 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ả Python CLI và TUI đều ghi các tạo phẩm vào một thư mục gói duy nhất trong thư mục gốc dự án của bạn, được tạo tự động nếu thiếu.

• 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 ra 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 Cursor IDE	—	—
skills/	Skene Skills — lược đồ backend có thể kết hợp cho Supabase	SQL	npm

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 Python CLI qua uvx. Mỗi gói có pipeline CI/CD độc lập.

Đóng Góp

Hoan nghênh đóng góp. Vui lòng mở một issue hoặc gửi pull request.

Giấy Phép

MIT