chatlab-import について
chatlab-importは、`clb` CLIでローカルのチャットエクスポートをChatLabに取り込むスキルです。書き込み内容を事前に確認し、その結果に基づいて処理を続けるか判断します。
主な機能
- 01書き込み計画の事前プレビュー
- 02セッション作成と差分更新
- 03重複メッセージ数の報告
- 04チャット内容の開示を制限
活用シーン
- 01ローカルのチャットエクスポートをChatLabへ取り込み
- 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 を使用してください。対応済みのインポートでは、どちらのスキルも必須ではありません。
ワークフロー
- CLI を確認し、正確なファイルパスを 1 つ特定します。
clb --help
CLI が見つからない場合は、npm install -g chatlab-cli でインストールするようユーザーに伝えてください。承認なしにソフトウェアをインストールしてはいけません。ユーザーが指定したファイルと対象を再利用してください。パスが曖昧なままの場合に限り確認し、すべてのコマンドでそのパスを引用符で囲んでください。
- 書き込みを行わずにインポートをプレビューします。
clb import "/absolute/path/to/chat-export.json" --dry-run --json
ユーザーが既存のセッションを選択した場合は、プレビューとインポートの両方に --session-id <session-id> を含めてください。
-
実行計画のみを要約します。作成モードまたは更新モード、対象セッション ID、スキャンしたメッセージ数、新規メッセージ数、重複数、照合方法または作成理由を含めてください。メッセージ本文を引用してはいけません。
-
ok: trueを必須とし、その後dataから計画を読み取って判断します。
- ユーザーがプレビューまたは確認のみを依頼した場合は、書き込みを行わずに終了します。
importModeがincrementalでnewMessageCountが0の場合は、セッションが最新であることを伝えて終了します。importModeがincrementalで新規メッセージがある場合は、再確認を求めずに自動的に続行します。importModeがcreatedの場合は、自動的に続行します。createReasonがambiguousの場合は、新しいセッションを作成して既存のセッションを維持し、この判断を最終結果で説明してください。- 結果から安全な操作を特定できない場合は、停止して不足している情報を説明します。
- 判断で書き込みが許可された場合は、
--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 回だけ再試行してください。それでもブロックされる場合は、際限なくポーリングせず、その旨を報告してください。