Skene
официальныйSkene — это набор инструментов для анализа кодовой базы, ориентированный на рост продукта. Он сканирует вашу кодовую базу, выявляет возможности для роста и генерирует практические планы внедрения.
Что можно делать с Skene MCP?
- Анализ кодовой базы для определения этапов пользовательского пути — попросите ассистента выполнить
analyse-journeyв вашем репозитории и вернуть выведенные этапы жизненного цикла с подтверждающими данными. - Включение доказательств из схемы базы данных — укажите ассистенту директорию с файлами
*.sqlчерез--schema-dir, чтобы анализ также учитывал вашу модель данных. - Проверка уверенности в этапах и исходных доказательств — попросите ассистента объяснить, какие пути кода или таблицы подтверждают каждый этап и насколько высока уверенность в обнаружении.
- Экспорт пути без специализированных названий этапов — запросите анализ с флагом
--no-specialize, чтобы сохранить канонические семиэтапные метки жизненного цикла.
Документация
Skene читает вашу кодовую базу и создает пользовательский путь для вашего продукта: этапы жизненного цикла, через которые проходит пользователь, вехи внутри каждого этапа, а также доказательства в коде или базе данных, подтверждающие реальность каждой вехи.
Быстрый старт
Установите и запустите интерактивный терминальный интерфейс:
curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
skene
Мастер проведет вас через выбор провайдера, аутентификацию и анализ — предварительная настройка не требуется.
Что он делает
Skene превращает репозиторий в единый journey.yaml, описывающий жизненный цикл пользователя вашего продукта, и отображает его в виде интерактивной диаграммы.
- Агентный анализ — два параллельных агента изучают ваш проект: один обходит кодовую базу, другой — ваши SQL-схемы. Каждый из них предлагает возможные вехи, которые затем объединяются и классифицируются по каноническому семиэтапному жизненному циклу.
- Семиэтапный пользовательский путь — каждый продукт сопоставляется с одними и теми же каноническими этапами (обнаружение, онбординг, активация, вовлечение, удержание, расширение, виральность), что позволяет сравнивать пути разных продуктов. Названия этапов при необходимости адаптируются под ваш продукт.
- Вехи, подкрепленные доказательствами — каждая веха содержит
tracked_event, оценкуconfidenceи один или несколько чиповevidence, указывающих на конкретный путь кода, таблицу базы данных или файл конфигурации, которые ее обосновывают. - Визуализатор пути — TUI открывает локальное веб-приложение, которое отображает этапы в виде колонок с карточками вех и кликабельными чипами доказательств, позволяя изучать путь вместе с исходным кодом.
- Только код, только схема или и то, и другое — запускайте анализ только по кодовой базе, только по директории с файлами
*.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
Если вы предпочитаете командную строку, вы можете запустить 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для записи в другое место.
Структура монорепозитория
| Директория | Описание | Язык | Дистрибуция |
|---|---|---|---|
src/skene/ | CLI + движок анализа | Python | PyPI |
tui/ | Интерактивный мастер терминального интерфейса | Go | GitHub Releases |
cursor-plugin/ | Плагин для Cursor IDE | — | — |
skills/ | Skene Skills — компонуемые бэкенд-схемы для Supabase | SQL | npm |
TUI (tui/) — это приложение на Bubble Tea, предоставляющее интерактивный мастер и управляющее Python CLI через uvx. Каждый пакет имеет независимые пайплайны CI/CD.
Участие в разработке
Вклад приветствуется. Пожалуйста, создайте issue или отправьте pull request.