Skene
官方Skene 是一个面向产品驱动增长(PLG)的代码库分析工具包。它能扫描你的代码库,发现增长机会,并生成可执行的实施方案。
你可以用 Skene MCP 做什么?
- 将代码库分析为用户旅程 — 让您的 AI 在仓库上运行
analyse-journey,生成一个journey.yaml,映射生命周期阶段、里程碑和证据。 - 结合代码与 SQL 模式分析 — 使用
--schema-dir将 Skene 指向包含*.sql文件的目录,使代码和数据库证据共同支撑每个里程碑。 - 自定义旅程输出 — 使用
-o将生成的journey.yaml重定向到特定路径,或使用--no-specialize保留标准阶段名称,而非产品特定名称。 - 启动交互式设置向导 — 让您的 AI 引导您安装并运行
skeneTUI,该界面可交互式处理提供商选择和身份验证。
文档
Skene 会读取你的代码库,并为你的产品生成一份用户旅程:用户经历的生命周期阶段、每个阶段中的里程碑,以及证明每个里程碑真实存在的代码或数据库证据。
快速开始
安装并启动交互式终端界面:
curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
skene
向导会引导你完成提供商选择、身份验证和分析——无需预先配置。
功能说明
Skene 将代码库转化为一份描述产品用户生命周期的 journey.yaml,并将其渲染为交互式图表。
- 智能分析 — 两个并行代理读取你的项目:一个遍历代码库,一个遍历 SQL 模式。它们各自提出候选里程碑,随后合并并分类为标准的七阶段生命周期。
- 七阶段用户旅程 — 每个产品都映射到相同的标准阶段(发现、引导、激活、参与、留存、扩展、传播),因此不同产品的旅程具有可比性。阶段名称会根据你的产品进行定制(如适用)。
- 有证据支持的里程碑 — 每个里程碑都带有
tracked_event、confidence评分,以及一个或多个evidence标签,指向证明其合理性的确切代码路径、数据库表或配置文件。 - 旅程可视化器 — TUI 会打开一个本地 Web 应用,将各阶段排列为列,包含里程碑卡片和可点击的证据标签,方便你对照底层源码审阅旅程。
- 仅代码、仅模式或两者兼有 — 可仅针对代码库、仅针对
*.sql文件目录运行,或两者同时运行以获得更丰富的证据。
支持 OpenAI、Gemini、Claude、LM Studio、Ollama 以及任何兼容 OpenAI 的端点。
安装
终端界面(推荐)
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以写入其他位置。
Monorepo 结构
| 目录 | 描述 | 语言 | 分发 |
|---|---|---|---|
src/skene/ | CLI + 分析引擎 | Python | PyPI |
tui/ | 交互式终端界面向导 | Go | GitHub Releases |
cursor-plugin/ | Cursor IDE 插件 | — | — |
TUI(tui/)是一个 Bubble Tea 应用,提供交互式向导体验,并通过 uvx 编排 Python CLI。每个包都有独立的 CI/CD 流水线。