mcpField
C
chatlab-import

chatlab-import

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

chatlab-import について

chatlab-importは、`clb` CLIでローカルのチャットエクスポートをChatLabに取り込むスキルです。書き込み内容を事前に確認し、その結果に基づいて処理を続けるか判断します。

主な機能

  1. 01書き込み計画の事前プレビュー
  2. 02セッション作成と差分更新
  3. 03重複メッセージ数の報告
  4. 04チャット内容の開示を制限

活用シーン

  1. 01ローカルのチャットエクスポートをChatLabへ取り込み
  2. 02計画を確認してからセッションを更新

インストール

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

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

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

同梱ファイルagents/openai.yaml

詳細

ChatLab インポート

clb CLI を使ってローカルのチャットエクスポートをインポートします。書き込み内容は必ず事前にプレビューしてください。インポートを明示的に依頼された場合、プレビューが成功した後の続行は承認済みとして扱い、2 回目の確認は求めないでください。

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

インポート済みのレコードを分析する場合は、利用可能であれば chatlab-analyze を使用してください。未対応のソースの場合は、利用可能であれば chatlab-convert を使用してください。対応済みのインポートでは、どちらのスキルも必須ではありません。

ワークフロー

  1. CLI を確認し、正確なファイルパスを 1 つ特定します。
clb --help

CLI が見つからない場合は、npm install -g chatlab-cli でインストールするようユーザーに伝えてください。承認なしにソフトウェアをインストールしてはいけません。ユーザーが指定したファイルと対象を再利用してください。パスが曖昧なままの場合に限り確認し、すべてのコマンドでそのパスを引用符で囲んでください。

  1. 書き込みを行わずにインポートをプレビューします。
clb import "/absolute/path/to/chat-export.json" --dry-run --json

ユーザーが既存のセッションを選択した場合は、プレビューとインポートの両方に --session-id <session-id> を含めてください。

  1. 実行計画のみを要約します。作成モードまたは更新モード、対象セッション ID、スキャンしたメッセージ数、新規メッセージ数、重複数、照合方法または作成理由を含めてください。メッセージ本文を引用してはいけません。

  2. ok: true を必須とし、その後 data から計画を読み取って判断します。

  • ユーザーがプレビューまたは確認のみを依頼した場合は、書き込みを行わずに終了します。
  • importMode が incremental で newMessageCount が 0 の場合は、セッションが最新であることを伝えて終了します。
  • importMode が incremental で新規メッセージがある場合は、再確認を求めずに自動的に続行します。
  • importMode が created の場合は、自動的に続行します。createReason が ambiguous の場合は、新しいセッションを作成して既存のセッションを維持し、この判断を最終結果で説明してください。
  • 結果から安全な操作を特定できない場合は、停止して不足している情報を説明します。
  1. 判断で書き込みが許可された場合は、--dry-run を付けずに同じコマンドを実行し、ファイル、対象、形式は変更しないでください。
clb import "/absolute/path/to/chat-export.json" --json

最終 JSON エンベロープから、結果のセッション ID、インポートモード、新規メッセージ数、重複数を報告してください。

ガードレール

  • プレビューを省略したり、ChatLab データベースを直接編集したり、セッションを削除または統合したりしてはいけません。
  • チャットエクスポート全体やメッセージ本文を開示してはいけません。
  • ファイルパス、パーサー形式、セッション ID を捏造してはいけません。
  • error.hint に従うのは、修正内容が明確な場合に限ります。
  • FILE_NOT_FOUND または INVALID_SESSION_ID の場合は、利用可能なコンテキストから値を特定するか、正しい値を尋ねてください。UNRECOGNIZED_FORMAT の場合は、clb formats を確認してください。IMPORT_IN_PROGRESS の場合は、実行中のインポートが終了した後に 1 回だけ再試行してください。それでもブロックされる場合は、際限なくポーリングせず、その旨を報告してください。

コメント