Skene

   

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

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

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

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

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

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

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

• การวิเคราะห์แบบเอเจนต์ — เอเจนต์สองตัวทำงานคู่กันเพื่ออ่านโปรเจกต์ของคุณ: ตัวหนึ่งสำรวจโค้ดเบส อีกตัวสำรวจสคีมา SQL ของคุณ แต่ละตัวเสนอเป้าหมายย่อยที่อาจเป็นไปได้ จากนั้นจะถูกรวมและจัดหมวดหมู่เป็นวงจรชีวิตเจ็ดขั้นตอนมาตรฐาน
• เส้นทางผู้ใช้เจ็ดขั้นตอน — ทุกผลิตภัณฑ์แมปกับขั้นตอนมาตรฐานเดียวกัน (การค้นพบ, การเริ่มต้นใช้งาน, การเปิดใช้งาน, การมีส่วนร่วม, การรักษาผู้ใช้, การขยาย, การแพร่กระจาย) เพื่อให้เส้นทางเปรียบเทียบข้ามผลิตภัณฑ์ได้ ชื่อขั้นตอนจะถูกปรับให้เฉพาะกับผลิตภัณฑ์ของคุณเมื่อมีประโยชน์
• เป้าหมายย่อยที่ backed ด้วยหลักฐาน — แต่ละเป้าหมายย่อยมี 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

หากคุณต้องการใช้บรรทัดคำสั่ง คุณสามารถรัน Skene ได้โดยตรงด้วย uvx (ไม่ต้องติดตั้ง) หรือติดตั้งแบบทั่วโลก:

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

โครงสร้าง Monorepo

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

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

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

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

ลิขสิทธิ์

MIT