データ分析

データウェアハウスにクエリを実行して、ビジネス上の質問に答えます。最初の exec 呼び出し時にカーネルは自動起動します。

以下のすべての CLI コマンドはこのスキルのディレクトリからの相対パスです。 scripts/cli.py コマンドを実行する前に、このファイルを含むディレクトリに cd してください。

ワークフロー

1. パターンルックアップ — キャッシュされたクエリ戦略を確認します:

   uv run scripts/cli.py pattern lookup "<ユーザーの質問>"
   

   パターンが存在する場合、その戦略に従います。実行後に結果を記録します:

   uv run scripts/cli.py pattern record <name> --success  # または --failure
   

2. コンセプトルックアップ — 既知のテーブルマッピングを探します:

   uv run scripts/cli.py concept lookup <concept>
   

3. テーブル発見 — キャッシュがない場合、コードベース (Grep pattern="<concept>" glob="**/*.sql") を検索するか、INFORMATION_SCHEMA にクエリを実行します。reference/discovery-warehouse.md を参照してください。

4. クエリ実行:

   uv run scripts/cli.py exec "df = run_sql('SELECT ...')"
   uv run scripts/cli.py exec "print(df)"
   

5. 学習内容をキャッシュ — 常に結果を提示する前にキャッシュします:

   # コンセプト → テーブルマッピングをキャッシュ
   uv run scripts/cli.py concept learn <concept> <TABLE> -k <KEY_COL>
   # クエリ戦略をキャッシュ (発見が必要だった場合)
   uv run scripts/cli.py pattern learn <name> -q "question" -s "step" -t "TABLE" -g "gotcha"
   

6. 結果をユーザーに提示 します。

カーネル関数

pl (Polars) と pd (Pandas) は事前にインポートされています。

CLI リファレンス

カーネル

uv run scripts/cli.py warehouse list      # ウェアハウス一覧表示
uv run scripts/cli.py start [-w name]     # カーネル起動 (オプショナルウェアハウス)
uv run scripts/cli.py exec "..."          # Python コード実行
uv run scripts/cli.py status              # カーネルステータス
uv run scripts/cli.py restart             # カーネル再起動
uv run scripts/cli.py stop                # カーネル停止
uv run scripts/cli.py install <pkg>       # パッケージをインストール

コンセプトキャッシュ

uv run scripts/cli.py concept lookup <name>                     # ルックアップ
uv run scripts/cli.py concept learn <name> <TABLE> -k <KEY_COL> # 学習
uv run scripts/cli.py concept list                               # すべてリスト表示
uv run scripts/cli.py concept import -p /path/to/warehouse.md   # 一括インポート

パターンキャッシュ

uv run scripts/cli.py pattern lookup "question"                                      # ルックアップ
uv run scripts/cli.py pattern learn <name> -q "..." -s "..." -t "TABLE" -g "gotcha"  # 学習
uv run scripts/cli.py pattern record <name> --success                                # 結果を記録
uv run scripts/cli.py pattern list                                                   # すべてリスト表示
uv run scripts/cli.py pattern delete <name>                                          # 削除

テーブルスキーマキャッシュ

uv run scripts/cli.py table lookup <TABLE>            # スキーマをルックアップ
uv run scripts/cli.py table cache <TABLE> -c '[...]'  # スキーマをキャッシュ
uv run scripts/cli.py table list                       # キャッシュ済みをリスト表示
uv run scripts/cli.py table delete <TABLE>             # 削除

キャッシュ管理

uv run scripts/cli.py cache status                # 統計情報
uv run scripts/cli.py cache clear [--stale-only]  # クリア

リファレンス

• reference/discovery-warehouse.md — 大規模テーブル処理、ウェアハウス探索、INFORMATION_SCHEMA クエリ
• reference/common-patterns.md — トレンド、比較、Top-N、分布、コホート向けの SQL テンプレート