session-search について
session-searchは、作業内容、決定事項、コードパターンをもとにClaude-CodeまたはCodex-CLIの過去のセッションを探すスキルです。aichatで検索し、関連する知見とセッション参照をまとめます。必要に応じて最大3件のセッションファイルを確認できます。
主な機能
- 01aichatによるセッション検索
- 02プロジェクト単位の絞り込み
- 03最大3件のセッションファイルを確認
- 04知見とセッション参照の要約
活用シーン
- 01設計上の決定を過去の会話から検索
- 02特定のコードパターンに関する以前の作業を特定
- 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)を検索して見つけます。
ワークフロー
- クエリを理解する:ユーザーが探しているもの(コードパターン、 決定、特定の作業、設計の方向性)を特定します。
- aichat で検索する:
aichat search --json -n 10 "[query]"を実行します(プロジェクトで絞り込むには-g "project"を使用します)。 - 結果を解析する:
jqを使用して JSONL 出力からフィールド(session_id、project、created、snippet、file_path)を抽出します。 - 必要に応じて詳細を調べる:セッションファイルを
~/.claude/projects/*/[session-id].jsonlで読み込みます(最大 3 ファイル)。 - 要約する:主な調査結果と参照情報を含む、要点を絞った要約を返します。
利用可能なすべてのオプション(日付フィルター、ブランチフィルターなど)と
JSONL のフィールド名を確認するには、aichat search --help を実行してください。
出力形式
次の内容を含む簡潔な要約を返します。
- 主な調査結果:クエリに答える 2~3 個の箇条書き
- 関連するセッション:参照用のセッション ID と日付
- 具体的な内容:直接関連する場合はコードスニペットまたは引用
生の 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
コメント
Markdown 対応