mcpField
C
chatlab-analyze

chatlab-analyze

github.com/chatlabデータ・データベース7.6k81 回インストール1 日前に更新
リポジトリ

chatlab-analyze について

chatlab-analyzeは、読み取り専用のclbコマンドラインで、ChatLabに取り込み済みの記録を検索・分析するスキルです。メッセージ、トピック、統計を絞り込んで調べられ、プライバシー処理と証拠参照を維持します。

主な機能

  1. 01メッセージと会話範囲の検索
  2. 02トピック一覧と統計の照会
  3. 03メッセージ前後のコンテキスト取得
  4. 04必要に応じたページ結果の継続取得
  5. 05読み取り専用SQLによる補完
  6. 06プライバシー処理の維持

活用シーン

  1. 01セッションと期間を指定したメッセージ検索
  2. 02最近の会話におけるトピックの確認
  3. 03キーワード数やメッセージ文脈の照会
  4. 04チャット全体を公開せずに記録を分析

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/chatlab/chatlab --skill chatlab-analyze

インストール後、Claude Code で/chatlab-analyzeを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

ChatLab 分析

読み取り専用の clb CLI を使って、ChatLab にすでにインポートされている記録を検索・分析します。

ユーザーが指定した言語で回答してください。指定がない場合は、会話で使われている言語を使用し、該当する場合はユーザーの中国語の変種を維持してください。コマンド、フィールド名、ID、証拠マーカーは変更しないでください。

新しいチャットのエクスポートをインポートする場合、利用可能であれば chatlab-import を使用してください。利用できない場合は、clb import --help に従い、書き込み前にインポート内容を正確にプレビューしてください。

ワークフロー

1. クエリを準備する

タスクごとに、現在のコマンド仕様を一度読み込みます。対象がまだ特定されていない場合に限り、セッションを一覧表示します。

clb manifest
clb sessions list --format json

会話内ですでに特定されているセッション、メンバー、期間を再利用してください。返された候補とコンテキストから重要な曖昧さを解消できない場合に限り、質問してください。CLI を利用できない場合は、不足している機能を報告してください。インストールには許可が必要です。

2. 専用コマンドから始める

質問に直接答えられる最も簡単なコマンドを使用します。

clb messages search "<keyword>" --session <session-id> --format agent
clb messages between --member me --member <member> --session <session-id> --last 90d --format agent
clb topics list --session <session-id> --last 30d --format agent

メッセージ本文には --format agent を使用し、セッション、メンバー、件数、--no-content 検索などの構造的な調査には --format json を使用してください。

3. コンテキストまたは統計を追加する

最初の結果だけでは不十分な場合に限り、クエリをさらに掘り下げます。

clb messages context --id 1021 --session <session-id> --window 10 --format agent
clb stats keywords --session <session-id> --member <member> --last 90d --top 20 --format json

さらに証拠が必要で、meta.hasMore が true の場合は、同じクエリ条件を指定して --cursor <meta.nextCursor> を使い、続きを取得してください。質問に答えられた時点で停止してください。部分的な範囲しか確認できていない場合は、ページ全体をデータセット全体として扱わず、その旨を明示してください。

4. 最後の手段として SQL を使う

質問に答えられる専用コマンドがない場合に限り、読み取り専用 SQL を使用します。

clb schema --session <session-id> --format json
clb sql "SELECT COUNT(*) AS n FROM message" --session <session-id> --format json

プライバシーと回答

  • クエリではプライバシー保護の前処理を有効にしたままにしてください。--raw を使用したり、データや設定を変更したりしないでください。インポートの別途依頼には、インポートのワークフローに従います。
  • チャットの内容全体を公開しないでください。ChatLab の安全な出力には、ユーザーのプライバシー保護の前処理が適用されます。
  • 利用可能な証拠は [#1021]、[#1021*]、または [#1021-1024] を使って引用してください。messages context --id に渡せるのは個別の ID のみです。結合された範囲は表示専用です。
  • まず回答を示し、検索対象のセッションと期間を明記してから、観察された事実と解釈を分けてください。
  • 人間関係の分析では、感情的な意図を過度に断定しないでください。修正内容が明確な場合に限り、error.hint に従ってください。

コメント

Markdown 対応