mcpField
L
local-conversation-history

local-conversation-history

github.com/daymadeエージェントワークフロー1.5k286 回インストール今日更新
リポジトリ

local-conversation-history について

Claude Code、OpenAI Codex、Kimi CLI のローカル会話履歴を扱うエージェント向けルーティングスキルです。依頼内容に応じて専用の読取・作業継続スキルへ振り分け、バックアップ確認や検索範囲、証拠の検証方法も定めます。

主な機能

  1. 01プラットフォームと意図による振り分け
  2. 02証拠の読取と作業継続の分離
  3. 03複数プロバイダー検索範囲の指定
  4. 04継続前の読取結果検証
  5. 05読取専用のバックアップ健全性確認

活用シーン

  1. 01トピックや引用から過去の会話を検索
  2. 02複数プロバイダーの最近のセッション一覧
  3. 03バックアップ範囲と復元可能性の確認
  4. 04検証済みセッションから作業を再開

インストール

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

$npx skills add https://github.com/daymade/claude-code-skills --skill local-conversation-history

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

詳細

ローカル会話履歴 — ルーター

このスキルは、どのスキルを実行するかを判断します。履歴自体を解析することも、特定のプロバイダー向けのコマンドを所有することも、実行スキルがすでに行う処理を再実装することもありません。特定のプロバイダー向けのフラグを説明していることに気づいたら、このスキルの担当範囲ではありません。引き継いで終了してください。

プラットフォーム × アクションでルーティングする

バックアップの健全性に関する依頼(「会話のバックアップは正常に機能していますか?」/「历史备份是否正常」)では、履歴リーダーを選ぶ前に、管理元のバックアップ設定とストレージ SOP を確認してください。そのスキルがインストールされている場合は、git-large-files-storage-setup のバックアップ健全性ワークフローを使用してください。そうでない場合は、既存のストレージ管理者の手順に従い、不足している依存関係があれば報告してください。このルートでは読み取りのみを行ってください。プロバイダー/ソースのカバレッジ、実際のバックアップ実行、保存先のオリジナル、復旧サンプル、アラートジョブをそれぞれ個別に検証してください。バックアップを確認するために、一時停止中のコレクターを再開したり、インデックスを再構築したりしないでください。プロバイダーリーダーは、選択したオリジナル/セッションの識別確認にのみ使用し、バックアップジョブを見つけるための会話本文検索には使用しないでください。アカウント、マシン、認証情報のパスは、ユーザー側の管理元設定に保持してください。

ルーティングの前に、会話が行われたプラットフォームと、ユーザーが求めているのが証拠(何が話されたか/行われたか)なのか、再開(作業を引き継いで進めること)なのかを確認してください。

プラットフォーム証拠を読む作業を続ける
Claude Codedaymade-claude-code:read-claude-code-historydaymade-claude-code:continue-claude-code-work
OpenAI Codexdaymade-claude-code:read-codex-historydaymade-claude-code:continue-codex-work
Kimi CLIread-claude-code-history。Kimi の対象範囲を指定してください — プロバイダーの対象範囲を参照継続用のスキルはありません

作業の再開は、必ず履歴を読んだ後に行います。継続用のスキルには、検証済みの読み取りレシートが必要です。レシートなしで直接ルーティングするのは近道ではなく、不備です。

プラットフォームが明示されていない場合は、正確な識別情報と内容の記憶を切り分けてください。完全なセッション ID がある場合は、まず Codex の完全一致 ID ロケーターを使用し、それで確認できなければ Claude Code の完全一致セッション検索を使用してください。検証済みのオリジナル記録によってプロバイダーと継続用スキルが決まります。ID の接頭辞では決まりません。タイトル、日付、引用、記憶しているトピックしかない場合は、以下の一覧またはコンテンツ検索ルートを使用し、プロバイダーを割り当てる前にオリジナルのメッセージを検証してください。

プロバイダーの対象範囲 — このエントリーポイントがルーティングするジョブのみ

引き継ぐ前に、対象のプロバイダーを指定してください。在庫の確認と内容の想起では実行器が異なります。複数のプロバイダーにまたがるリクエストに、プロバイダー固有の既定値が対応すると想定しないでください。

プロバイダー横断のニーズルーティング先このスキルで指定する対象範囲
在庫 — 「これまで何に取り組んできたか」「最近のチャットを一覧表示して」「セッションのタイトル/日付/ID」利用可能な場合はインデックス化されたメタデータ、次に特定セッションのリーダーlist_local_history.py --source all は使用しないでください。日付と出力の制限は、Claude のセッション本文を読み取った後に適用されます。インデックス化された在庫情報が存在しない場合は、その不足を報告してください。
内容検索 — 「Xについて話したことがあるか」、引用、ファイル、ツールの結果を見つけるread-claude-code-history、そのインデックス化された想起機能、次に特定セッションのリーダー関連するインデックス化済みプロバイダーを選択し、インデックスの対象範囲と鮮度を確認してください。候補となるセッションのみを開いてください。
ランキングによる想起 — 表現が変わっている可能性がある場合read-claude-code-history、そのハイブリッド想起インデックスインデックスに含まれるプロバイダーが明記されています。インデックス化されていないプロバイダーまで対象だと推測しないでください。

インデックス化された想起では、Claude、Codex、Kimi のプロバイダーを明示的にフィルターできます。

広範な検索を行う前に、与えられた手がかりを使ってください。 引用文が貼り付けられ、プロジェクト、日付、またはタイトルがわかっている場合は、インデックス化されたメタデータで候補を絞り込んでから、元のメッセージを検証してください。Codex の場合は、read-codex-history の 引用されたやり取りを特定する に従ってください。在庫情報だけでは内容の一致を確認できません。候補が見つからない場合や対象範囲が不完全な場合は、不足を報告し、インデックス化されたクエリを絞り込んでください。現在の Session は除外してください。ID のみを求められた場合は、検証済みのメッセージの証拠が得られた時点で終了します。無関係なすべての会話を再構築する必要はありません。

履歴の検索には、インデックスか、既知の特定セッションを使ってください。 出力制限やスキャンのタイムアウトを設定していても、すべての会話を生のまま総当たり検索することは禁止されています。現在の生検索の日付フラグはファイルを読み取った後にフィルターするため、そのコマンドを対象範囲の限られたものにはしません。インデックスがない、古い、またはプロバイダーが含まれていない場合は、その対象範囲の不足を報告してください。コーパス全体のスキャンにフォールバックしないでください。ランキング上位 K 件の結果から、該当するものが存在しないとは判断できません。

Kimi CLI はほかにエントリーポイントがありません — どちらの軸にも専用スキルはないため、上記の両方のルートは read-claude-code-history に到達し、そこに独自の Kimi ホームディレクトリの解決方法が記載されています。

特定セッションの検索、インデックス化されたプロバイダーフィルター、対象範囲、出力形式は実行器に任せてください。このスキルでは、対象となるプロバイダーを指定します。

ルートを決めるのは意図です。「履歴」という言葉ではありません

ユーザーが求める結果ルート
会話のバックアップが最新で、復元可能かどうか上記のバックアップ健全性ルート。プロバイダー/ソースと保存先の判定を分けて返し、対象範囲と復元の制限を示します
会話の一覧:タイトル、日付、セッション IDプロバイダーの対象範囲にあるインデックス化された一覧の行。利用できない場合は、その不足を伝えます
トピック、引用、ファイル、ツールの結果が登場した会話。「あの古いチャットを探して」「Xについて話したことはあった?」プロバイダーの対象範囲にあるインデックス化されたコンテンツ検索の行。まず提示された手がかりを使って候補を絞り込みます。タイトルの一覧だけでは、その内容が存在する証拠にはなりません
自分が入力した内容を、重複も含めて時系列順にそのまま確認すること該当するリーダーの逐語入力用パス。重複とセッションの境界を保持します。重複は記録の一部であり、ノイズではありません
停滞した可能性のある最近の依頼。「最近、最後まで終わらせるのを忘れたことはある?」/「最近提过却没推进的事」プロバイダーの対象範囲にあるインデックス化された一覧/コンテンツ検索ルートを使い、該当する完全なセッションのリーダーで確認します。候補は現在のプロジェクト記録と照合してください。プロジェクトレジストリだけでは、登録されていない依頼は網羅できません
特定したセッションの作業を再開すること読み取り後に、該当する継続スキルを使用します

求められた出力を優先し、背景にある動機には従いません。問題を説明した後で、自分が入力した内容の特定期間分を求められた場合は、その期間の内容を返します。説明に含まれるトピックの手がかりによって、依頼がコンテンツ検索に変わることはありません。

最近の未完了作業に関する依頼では、取得時の読み取り専用を維持します。求められた期間と関連するプロバイダーを特定し、インデックスの鮮度を確認して、選定したセッションだけを、それぞれを管理するリーダー経由で開きます。各候補の元のユーザー依頼を、直近の関連する引き継ぎまたは完了を示す証拠と照合し、未完了と判断する前に、プロジェクトの最新の決定/ステータス情報を確認します。完了済みの作業、ユーザーによって一時停止された作業、外部要因でブロックされている作業、受け入れ待ちの作業は、それぞれ区別します。リマインダー、アシスタントの計画、未完了の参照用ブックマークは手がかりとして扱い、未履行のコミットメントを示す証拠とはみなしません。候補、次のアクション、証拠の出典/日付、未解決の対象範囲の不足を報告します。求められた一覧の作成後は終了し、許可がない限り、過去の作業を再開したり、タスクを移行したりしません。この照合作業は呼び出し元のエージェントが行います。リーダーが担うのは情報の取得であり、機械的なチェックだけでは現実世界での完了を確認できません。

ルーティングをまたいで維持される不変条件

記憶された事実について検索する前に、正確な命題を特定してください。アカウント数、アカウントのユーザー、イベントの実行主体は、それぞれ異なる問いです。選択したセッションで、3 つの証拠経路を確認してください。ユーザーの直接の発言、参照先を特定するためのアシスタントによる言い換え、そしてツールが過去に読み取った外部の原記録です。アシスタントの引用は情報源の場所を示すものであり、その情報源に取って代わるものではありません。対象が過去に読み取られた記録である場合は、プロバイダーのリーダーが備える完全なツール証拠経路を使用してください。

ユーザーが「もう一度検索して」と言ったら、検索元、インデックスに登録されたプロバイダー/日付/プロジェクトの範囲、文字列検索と意味検索の別、または選択したセッションの原記録など、具体的な検索条件を変えてください。同じランキング付きの文章検索を、類義語だけ変えて再実行して終わらせてはいけません。どの範囲を変えたか明示してください。見つかった副次的な主張と、見つからなかった残りの部分は分けてください。過去の表現が見つからなくても、現在のユーザーによる明示的な事実を優先します。記録をエクスポートする際、元の証拠の値を保持し、保存されたテキストを黙って伏せたり、置き換えたり、要約したりしてはいけません。

  • 範囲。 インデックスのプロバイダーと情報源の範囲、および最新性の境界を確認してください。その範囲外のアーカイブやプロバイダーは不明です。必要な情報源が欠けている場合、不在を主張する根拠にはなりません。
  • 自己一致。 現在のセッションにはユーザーの質問と、このエージェント自身のコマンドが記録されるため、自分自身に関するほぼあらゆる検索語句に一致します。ヒットを過去の証拠として扱う前に、現在のセッション ID を除外してください。
  • ゼロ件でも不在とは限りません。 ランキング検索では、異なる言い回しや未インデックスの記録を見逃すことがあります。範囲を明示し、空の結果を「起きたことがない」と読み替えてはいけません。
  • ある言葉がトピックの名称なのか、その人が実際に使う言い方なのかを確認してください。 ユーザーが実際には「用哪个」や「不要闭门造车」と言っているコーパスで 技术选型 を検索すると、ほとんど何も見つかりません。実測では、本当の出現数が 163 件あるのに対し、ヒットは 10 件でした。中国語のフレーズはトークン境界でしか一致しないためです。特定の人のコーパスを検索するときは、設計書で使われるようなトピック名ではなく、その人の話し方、つまり命令形、否定表現、具体的な状況を表す文を検索してください。トピック名でヒットがゼロでも、不在を主張する根拠にはなりません。まず、その人が実際に使ったと思われる表現に検索を広げ、試した表現を明示してください。
  • ゼロ件になる原因は 3 つあり、「履歴がない」はそのうちの 1 つにすぎません。 残る 2 つは、ホームが見つからなかったことと、範囲からすべてが除外されていたことです。どの原因も、空のテーブルでは見分けられません。特に Kimi ではこの問題が起きやすくなります。ドキュメントに記載されたデフォルトのホームは、すべてのインストール環境で使われるわけではありません。デスクトップクライアントが CLI を独自のランタイムに同梱して、セッションをそこに保存する場合があります。また、セッションはそれぞれ固有のワークスペースに属するため、別のリポジトリ内でデフォルト設定のまま実行すると、会話が多数保存されたストアでも何も返らないことがあります。不在を報告する前に、この 2 つの可能性をどちらも除外してください。実際に読み取ったホームを示し、適用されていたプロジェクトの範囲も明示してください。ホームが見つからない場合、インベントリには診断行が出力されるため、表示されたら引用してください。ただし、見つかったホームからゼロ件が返された場合は診断が出力されません。また、検索パスはどちらの場合も診断を出力しません。そのため、無言の空結果を、リーダーが不在を確認した証拠として扱ってはいけません。ホームの場所とインベントリに必要な範囲フラグの特定は、read-claude-code-history が担います。

禁止事項

  • ここでは、プロバイダー固有の解析、SQLite、rg、jq、JSONL パイプラインを実行しないでください。これらはすべて、各ストアのスキーマ、アーカイブ、障害モードをすでに処理するエグゼキューターに任されています。
  • プロバイダーのスコープを指定する3つのオプション(--source、--codex、--kimi)を除き、エグゼキューターのフラグをこのファイルにコピーしないでください。これらはこのスキル自体が扱う対象です。それ以外のフラグはエグゼキューターの変更に合わせて更新されるため、ここにコピーするとこのファイルは気づかれないまま古くなり、誤ったコマンドを教えることになります。
  • 過去についての質問に答えるために、継続用のスキルに処理を引き継がないでください。読み取りは証拠を得る行為ですが、継続は世界を変える行為です。

コメント