mcpField
S
session-search

session-search

github.com/glebisエージェントワークフロー403189 回インストール3 日前に更新
リポジトリ

session-search について

Session Searchは、過去のプロジェクト作業、デバッグ、調査に関するClaude Codeの会話を探すスキルです。キーワードで候補を絞り、意味に基づいて関連度を評価して結果を並べます。

主な機能

  1. 01Claude Codeの会話履歴を検索
  2. 02キーワードによる事前絞り込み
  3. 03意味に基づく関連度の評価
  4. 04結果の順位付けと要約表示
  5. 05件数と検索期間の調整

活用シーン

  1. 01特定の話題を扱った過去の会話を探す
  2. 02特定のエラーを扱った記録を見つける
  3. 03以前の調査やプロジェクト作業を検索
  4. 04検索件数や対象期間を広げる

インストール

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

$npx skills add https://github.com/glebis/claude-skills --skill session-search

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

同梱ファイル.claude-plugin/plugin.jsonscripts/search.py

詳細

セッション検索

キーワードによる事前絞り込みとセマンティック評価を組み合わせて、Claude Code のセッショントランスクリプトを検索します。特定のトピック、デバッグの会話、調査タスク、その他過去の作業に関する以前のセッションを見つけられます。

ワークフロー

ステップ 1：検索スクリプトを実行する

ユーザーのクエリを指定して scripts/search.py を実行します。

python3 scripts/search.py "<query>" [max_results] [max_age_days]
  • query（必須）：自然言語による検索クエリ
  • max_results（任意、デフォルトは 10）：返す結果の最大数
  • max_age_days（任意、デフォルトは 90）：検索対象とする過去の日数

このスクリプトは、すべてのセッションを対象にキーワードで事前絞り込みを行った後、上位候補から意味のある抜粋を抽出します。出力には SESSIONS_DATA の JSON ブロックが含まれます。

ステップ 2：結果をセマンティックに評価する

スクリプトの出力を受け取ったら、各セッションがクエリにどの程度関連するかを評価します。次の点を考慮してください。

  • 同義語の照合：「bug」は「error」、「issue」、「problem」、「fix」に一致します
  • 関連する概念：「debugging」はテストの失敗やエラーメッセージを含むセッションに一致します
  • ツールのパターン：「refactoring」は Edit の多いセッションに一致します
  • ドメインのコンテキスト：「obsidian」はボルトに関連する作業に一致します

抜粋の内容とクエリの意図に基づいて、各セッションに関連度スコア（0～10）を付けます。

ステップ 3：結果を提示する

関連度の高い順に並べた上位の結果（max_results 件まで）を、次の形式で表示します。

### [Relevance: N/10] Project — Date
Summary of what the session was about (1-2 sentences based on excerpts)
`claude --resume <session-id>`

関連する結果が見つからない場合は、その旨を伝え、別のクエリを提案してください。

セッションの保存場所

セッションは ~/.claude/projects/ 内の JSONL ファイルとして保存されます。各ファイルには、ユーザーとアシスタントのメッセージやツール呼び出しを含むイベントが記録されています。検索スクリプトがファイルの検出とテキスト抽出を自動的に処理します。

カスタマイズ

過去のセッションを検索したり、結果を増やしたりするには、次のようにします。

/session-search "query" 20 180

（20 件の結果、過去 180 日間を検索）

コメント

Markdown 対応