Skene
公式Skeneは、プロダクト主導型成長のためのコードベース分析ツールキットです。コードベースをスキャンし、成長機会を検出し、実行可能な実装計画を生成します。
Skene MCPで何ができますか?
- コードベースをユーザージャーニーに分析する — AIにリポジトリ上で
analyse-journeyを実行させ、ライフサイクルステージ、マイルストーン、および証拠をマッピングしたjourney.yamlを生成させます。 - コードとSQLスキーマ分析を組み合わせる —
--schema-dirを使用してSkeneを*.sqlファイルのディレクトリに指定し、コードとデータベースの両方の証拠が各マイルストーンを裏付けるようにします。 - ジャーニー出力をカスタマイズする —
-oを使用して生成されたjourney.yamlを特定のパスにリダイレクトするか、--no-specializeを使用して製品固有の名前ではなく標準のステージ名を保持します。 - 対話型セットアップウィザードを起動する — AIに
skeneTUIのインストールと実行をガイドさせます。これにより、プロバイダーの選択と認証が対話的に処理されます。
ドキュメント
Skeneはコードベースを読み取り、製品のユーザージャーニーを生成します。ユーザーが通過するライフサイクルステージ、各ステージ内のマイルストーン、そして各マイルストーンが実際に存在することを証明するコードまたはデータベースの証拠をまとめます。
クイックスタート
インタラクティブなターミナルUIをインストールして起動します:
curl -fsSL https://raw.githubusercontent.com/SkeneTechnologies/skene/main/tui/install.sh | bash
skene
ウィザードがプロバイダー選択、認証、分析を順に案内します。事前設定は不要です。
機能概要
Skeneはリポジトリを、製品のユーザーライフサイクルを説明する単一のjourney.yamlに変換し、インタラクティブな図として表示します。
- エージェント型分析 — 2つの並行エージェントがプロジェクトを読み取ります。1つはコードベースを、もう1つはSQLスキーマを調査します。それぞれが候補となるマイルストーンを提案し、それらを統合・分類して標準的な7段階のライフサイクルに整理します。
- 7段階のユーザージャーニー — すべての製品は同じ標準ステージ(発見、オンボーディング、アクティベーション、エンゲージメント、リテンション、拡張、バイラリティ)にマッピングされるため、製品間でジャーニーを比較できます。ステージ名は必要に応じて製品に特化させます。
- 証拠に基づくマイルストーン — 各マイルストーンには
tracked_event、confidenceスコア、およびそれを正当化する正確なコードパス、データベーステーブル、または設定ファイルを指し示す1つ以上のevidenceチップが付属します。 - ジャーニービジュアライザー — TUIはローカルWebアプリを開き、ステージを列として配置し、マイルストーンカードとクリック可能な証拠チップを表示します。基盤となるソースコードと一緒にジャーニーを確認できます。
- コードのみ、スキーマのみ、または両方 — コードベースのみ、
*.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
コマンドラインを好む場合は、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を渡して別の場所に書き込みます。
モノレポ構成
| ディレクトリ | 説明 | 言語 | 配布 |
|---|---|---|---|
src/skene/ | CLI + 分析エンジン | Python | PyPI |
tui/ | インタラクティブなターミナルUIウィザード | Go | GitHub Releases |
cursor-plugin/ | Cursor IDEプラグイン | — | — |
TUI(tui/)はBubble Teaアプリで、インタラクティブなウィザード体験を提供し、uvxを介してPython CLIをオーケストレーションします。各パッケージには独立したCI/CDパイプラインがあります。
貢献
貢献を歓迎します。イシューを開くか、プルリクエストを送信してください。