mcpField
S
session-search

session-search

github.com/pchalasaniエージェントワークフロー2.0k42 回インストール1 日前に更新
リポジトリ

session-search について

session-searchは、作業内容、決定事項、コードパターンをもとにClaude-CodeまたはCodex-CLIの過去のセッションを探すスキルです。aichatで検索し、関連する知見とセッション参照をまとめます。必要に応じて最大3件のセッションファイルを確認できます。

主な機能

  1. 01aichatによるセッション検索
  2. 02プロジェクト単位の絞り込み
  3. 03最大3件のセッションファイルを確認
  4. 04知見とセッション参照の要約

活用シーン

  1. 01設計上の決定を過去の会話から検索
  2. 02特定のコードパターンに関する以前の作業を特定
  3. 03以前のタスクのセッション参照を取得

インストール

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

$npx skills add https://github.com/pchalasani/claude-code-tools --skill session-search

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

詳細

Claude Code を使用している場合: このスキルを直接使用しないでください。代わりに、Task ツール経由で session-searcher サブエージェントを使用してください。コンテキストを汚染せず、より 効率的に処理できます。

session-search

特定の作業、決定、コードパターンについて、過去のコーディングエージェントのセッション(Claude-Code または Codex-CLI)を検索して見つけます。

ワークフロー

  1. クエリを理解する:ユーザーが探しているもの(コードパターン、 決定、特定の作業、設計の方向性)を特定します。
  2. aichat で検索する:aichat search --json -n 10 "[query]" を実行します(プロジェクトで絞り込むには -g "project" を使用します)。
  3. 結果を解析する:jq を使用して JSONL 出力からフィールド(session_id、project、created、snippet、file_path)を抽出します。
  4. 必要に応じて詳細を調べる:セッションファイルを ~/.claude/projects/*/[session-id].jsonl で読み込みます(最大 3 ファイル)。
  5. 要約する:主な調査結果と参照情報を含む、要点を絞った要約を返します。

利用可能なすべてのオプション(日付フィルター、ブランチフィルターなど)と JSONL のフィールド名を確認するには、aichat search --help を実行してください。

出力形式

次の内容を含む簡潔な要約を返します。

  1. 主な調査結果:クエリに答える 2~3 個の箇条書き
  2. 関連するセッション:参照用のセッション ID と日付
  3. 具体的な内容:直接関連する場合はコードスニペットまたは引用

生の JSON ではなく、整った Markdown 形式にしてください。

例

クエリ:「認証設計について話し合ったセッションを探してください」

aichat search --json -n 10 "authentication design"

要約:

  • セッション abc123(12 月 10 日):JWT とセッションベース認証を比較し、JWT を採用
  • セッション def456(12 月 8 日):リフレッシュトークンのローテーションパターンを実装

制約

  • aichat search では必ず --json フラグを使用してください(使用しないと対話型 UI が起動します)。
  • 生の JSON 出力をユーザーに返さず、要約して要点をまとめてください。
  • クエリごとに読み込むセッションファイルは最大 3 個にしてください。
  • 結果が見つからない場合は、別の検索語句を提案してください。
  • ファイル内で直接確認できた情報のみを報告してください。推測や外挿はしないでください。

エラー処理

aichat search コマンドが失敗するか、見つからない場合は、ユーザーにインストールを依頼してください。

uv tool install claude-code-tools   # Python package
cargo install aichat-search         # Rust search TUI

前提条件:

  • Node.js 18+(アクションメニュー用)
  • Rust/Cargo(aichat-search 用)

ユーザーが uv または cargo を使用できない場合:

curl -LsSf https://astral.sh/uv/install.sh | sh           # uv
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh  # Rust

コメント