/analyze - データの質問に答える

馴染みのないプレースホルダーが表示される場合や、接続されているツールを確認する必要がある場合は、CONNECTORS.md をご覧ください。

簡単な検索から本格的な分析、正式なレポートまで、あらゆるデータの質問に答えます。

使い方

/analyze <自然言語の質問>

ワークフロー

1. 質問を理解する

ユーザーの質問を解析し、以下を判断します：

• 複雑さのレベル：
  • 簡単な答え：単一の指標、シンプルなフィルタ、事実の検索（例：「先週のユーザー登録数は？」）
  • 本格的な分析：多次元の調査、トレンド分析、比較（例：「コンバージョン率の低下の原因は？」）
  • 正式なレポート：方法論、注意点、推奨事項を含む包括的な調査（例：「四半期のサブスクリプション指標に関するビジネスレビューを作成してください」）
• データ要件：必要なテーブル、指標、ディメンション、期間
• 出力形式：数値、テーブル、チャート、ナレーティブ、またはそれらの組み合わせ

2. データを収集する

データウェアハウス MCP サーバーが接続されている場合：

1. スキーマを調査して関連するテーブルと列を見つける
2. 必要なデータを抽出する SQL クエリを作成する
3. クエリを実行して結果を取得する
4. クエリが失敗した場合は、デバッグして再試行します（列名、テーブル参照、特定のダイアレクトの構文を確認）
5. 結果が予期しない場合は、先に進む前にサニティチェックを実行します

データウェアハウスが接続されていない場合：

1. ユーザーに以下のいずれかの方法でデータを提供するよう依頼します：
   • クエリ結果を直接貼り付け
   • CSV または Excel ファイルをアップロード
   • スキーマを説明して、ユーザーが実行するクエリを作成できるようにします
2. 手動実行用のクエリを作成する場合は、sql-queries スキルを使用してダイアレクト固有のベストプラクティスに従います
3. データが提供されたら、分析に進みます

3. 分析を実施する

• 関連する指標、集計、比較を計算する
• パターン、トレンド、外れ値、異常を特定する
• ディメンション全体で比較する（期間、セグメント、カテゴリ）
• 複雑な分析の場合は、問題を小問に分割してそれぞれに対応します

4. 結果を提示する前に検証する

結果を共有する前に、以下の検証チェックを実行します：

• 行数の妥当性：レコード数が妥当ですか？
• Null チェック：予期しない Null があり、結果を歪める可能性がありますか？
• 規模チェック：数値は合理的な範囲内ですか？
• トレンドの連続性：時系列に予期しないギャップがありますか？
• 集計ロジック：小計が合計に正しく合計されていますか？

チェックで懸念が生じた場合は、調査して注意点を記述します。

5. 調査結果を提示する

簡単な答えの場合：

• 関連するコンテキストとともに答えを直接述べる
• 再現性のためにクエリを含めます（折りたたまれた形式またはコードブロック内）

本格的な分析の場合：

• 主要な発見または洞察を最初に示す
• データテーブルおよび/またはビジュアライゼーションでサポートする
• 方法論と注意点を記述する
• フォローアップの質問を提案する

正式なレポートの場合：

• 主要な収穫を含むエグゼクティブサマリー
• アプローチとデータソースを説明する方法論セクション
• 支持する証拠を伴う詳細な調査結果
• 注意点、制限事項、データ品質に関する注記
• 推奨事項と次のステップの提案

6. 役立つ場合は可視化する

テーブルよりもチャートがより効果的に結果を伝える場合：

• data-visualization スキルを使用して、適切なチャートタイプを選択します
• Python ビジュアライゼーションを生成するか、HTML ダッシュボードに統合します
• 明確性と正確性についてビジュアライゼーションのベストプラクティスに従います

例

簡単な答え：

/analyze 12月に登録した新規ユーザー数は？

本格的な分析：

/analyze 過去3ヶ月間のサポートチケット数の増加の原因は何ですか？ カテゴリと優先度で分析してください。

正式なレポート：

/analyze 顧客テーブルのデータ品質評価を作成してください。完全性、一貫性、対処すべき問題を含めます。

ヒント

• 可能であれば、時間範囲、セグメント、または指標について具体的に述べてください
• テーブル名がわかっている場合は、プロセスを高速化するために名前を記述してください
• 複雑な質問の場合、Claude は複数のクエリに分割することがあります
• 結果は常に提示前に検証されます。何か問題があれば、Claude がフラグを立てます