Skene MCP Server

   

Skene อ่านโค้ดเบสของคุณและสร้าง เส้นทางผู้ใช้ สำหรับผลิตภัณฑ์ของคุณ: ขั้นตอนวงจรชีวิตที่ผู้ใช้ดำเนินไป เหตุการณ์สำคัญภายในแต่ละขั้นตอน และหลักฐานจากโค้ดหรือฐานข้อมูลที่พิสูจน์ว่าแต่ละเหตุการณ์สำคัญมีอยู่จริง

เริ่มต้นอย่างรวดเร็ว

ติดตั้งและเปิดใช้ UI แบบโต้ตอบในเทอร์มินัล:

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

ตัวช่วยจะนำคุณผ่านการเลือกผู้ให้บริการ การยืนยันตัวตน และการวิเคราะห์ — ไม่จำเป็นต้องตั้งค่าล่วงหน้า

สิ่งที่มันทำ

Skene เปลี่ยน repository ให้เป็น journey.yaml เดียวที่อธิบายวงจรชีวิตผู้ใช้ของผลิตภัณฑ์ของคุณ และแสดงผลเป็นแผนภาพแบบโต้ตอบ

• การวิเคราะห์แบบเอเจนต์ — เอเจนต์สองตัวทำงานคู่ขนานกันอ่านโปรเจกต์ของคุณ: ตัวหนึ่งเดินดูโค้ดเบส อีกตัวเดินดู SQL schema ของคุณ แต่ละตัวเสนอเหตุการณ์สำคัญที่เป็นตัวเลือก จากนั้นจึงรวมและจัดประเภทเข้าสู่วงจรชีวิตเจ็ดขั้นตอนมาตรฐาน
• เส้นทางผู้ใช้เจ็ดขั้นตอน — ทุกผลิตภัณฑ์จะถูกจับคู่กับขั้นตอนมาตรฐานเดียวกัน (การค้นพบ, การเริ่มต้นใช้งาน, การกระตุ้น, การมีส่วนร่วม, การรักษาลูกค้า, การขยาย, การบอกต่อ) เพื่อให้สามารถเปรียบเทียบเส้นทางข้ามผลิตภัณฑ์ได้ ชื่อขั้นตอนจะถูกปรับให้เฉพาะเจาะจงกับผลิตภัณฑ์ของคุณตามความเหมาะสม
• เหตุการณ์สำคัญที่มีหลักฐานรองรับ — แต่ละเหตุการณ์สำคัญมี tracked_event, คะแนน confidence และชิป evidence หนึ่งตัวหรือมากกว่าที่ชี้กลับไปยังเส้นทางโค้ด ตารางฐานข้อมูล หรือไฟล์คอนฟิกที่แน่นอนซึ่งเป็นเหตุผลรองรับ
• ตัวแสดงเส้นทาง — TUI จะเปิดเว็บแอปในเครื่องที่จัดวางขั้นตอนเป็นคอลัมน์ พร้อมการ์ดเหตุการณ์สำคัญและชิปหลักฐานที่คลิกได้ เพื่อให้คุณสามารถตรวจสอบเส้นทางควบคู่ไปกับซอร์สโค้ด
• เฉพาะโค้ด, เฉพาะ schema, หรือทั้งสองอย่าง — รันกับเฉพาะโค้ดเบส, เฉพาะไดเรกทอรีของไฟล์ *.sql, หรือทั้งสองอย่างเพื่อหลักฐานที่สมบูรณ์ยิ่งขึ้น

รองรับ OpenAI, Gemini, Claude, LM Studio, Ollama และ endpoint ใดๆ ที่เข้ากันได้กับ OpenAI

การติดตั้ง

Terminal UI (แนะนำ)

TUI เป็นตัวช่วยแบบโต้ตอบที่นำคุณผ่านขั้นตอนการทำงานทั้งหมด ไม่มีข้อกำหนดเบื้องต้น — ตัวติดตั้งจัดการทุกอย่างให้

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

# Launch it
skene

Python CLI

หากคุณต้องการใช้บรรทัดคำสั่ง คุณสามารถรัน Skene โดยตรงด้วย uvx (ไม่ต้องติดตั้ง) หรือติดตั้งแบบ 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 .

แฟล็กที่มีประโยชน์:

• --schema-dir <dir> — ชี้ไปยังไดเรกทอรีของไฟล์ *.sql ที่ส่งออกเพื่อเปิดใช้งาน schema agent
• -o <path> — แทนที่ไฟล์เอาต์พุต (ค่าเริ่มต้น ./skene-context/journey.yaml)
• --no-specialize — เก็บชื่อขั้นตอนมาตรฐานไว้แทนที่จะให้ LLM ปรับให้เฉพาะเจาะจง

สำหรับการใช้งาน CLI แบบเต็ม ดู เอกสารประกอบ

โครงสร้างเอาต์พุต

ทั้ง Python CLI และ TUI จะเขียนอาร์ติแฟกต์ไปยังไดเรกทอรีบันเดิลเดียวในรูทโปรเจกต์ของคุณ ซึ่งจะสร้างขึ้นโดยอัตโนมัติหากยังไม่มี

• ค่าเริ่มต้น: ./skene-context/journey.yaml — เส้นทางผู้ใช้ที่วิเคราะห์แล้วสำหรับผลิตภัณฑ์ของคุณ
• การแทนที่: ตั้งค่า output_dir ใน .skene.config หรือส่ง -o/--output เพื่อเขียนไปยังที่อื่น

โครงสร้าง Monorepo

ไดเรกทอรี	คำอธิบาย	ภาษา	การแจกจ่าย
src/skene/	CLI + เอ็นจินวิเคราะห์	Python	PyPI
tui/	ตัวช่วย UI เทอร์มินัลแบบโต้ตอบ	Go	GitHub Releases
cursor-plugin/	ปลั๊กอิน Cursor IDE	—	—
skills/	Skene Skills — schema แบ็กเอนด์ที่ประกอบได้สำหรับ Supabase	SQL	npm

TUI (tui/) เป็นแอป Bubble Tea ที่มอบประสบการณ์ตัวช่วยแบบโต้ตอบและประสานงาน Python CLI ผ่าน uvx แต่ละแพ็กเกจมี CI/CD pipeline อิสระ

การมีส่วนร่วม

ยินดีรับการมีส่วนร่วม โปรด เปิด issue หรือส่ง pull request

ใบอนุญาต

MIT