mcpField
H
hybrid-search-implementation

hybrid-search-implementation

github.com/wshobsonデータ・データベース41.9k10.9k 回インストール2 週間前に更新
リポジトリ

hybrid-search-implementation について

検索システムを構築するエンジニア向けのスキルです。ベクトル類似検索とキーワード検索を組み合わせ、意味と完全一致の両方を求めるクエリに対応する融合・再ランキング手法を扱います。

主な機能

  1. 01ベクトル検索とキーワード検索
  2. 02RRF と重み付きスコアの融合
  3. 03クロスエンコーダーによる再ランキング
  4. 04カスケード検索パターン
  5. 05検索の調整と評価

活用シーン

  1. 01RAG システムの再現率向上
  2. 02名前やコードの完全一致検索
  3. 03専門分野の語彙の検索

インストール

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

$npx skills add https://github.com/wshobson/agents --skill hybrid-search-implementation

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

同梱ファイルreferences/details.md

詳細

ハイブリッド検索の実装

ベクトル類似度とキーワードベースの検索を組み合わせるパターンです。

このスキルを使用する場面

  • 再現率を向上させた RAG システムを構築する場合
  • 意味理解と完全一致を組み合わせる場合
  • 特定の用語(名前、コード)を含むクエリを処理する場合
  • ドメイン固有の語彙に対する検索を改善する場合
  • 純粋なベクトル検索がキーワード一致を取りこぼす場合

中核となる概念

1. ハイブリッド検索のアーキテクチャ
Query → ┬─► Vector Search ──► Candidates ─┐
        │                                  │
        └─► Keyword Search ─► Candidates ─┴─► Fusion ─► Results
2. 融合手法
手法説明最適な用途
RRF順位逆数融合汎用
Linearスコアの重み付き和調整可能なバランス
Cross-encoderニューラルモデルによる再ランク最高品質
Cascadeフィルタ後に再ランク効率性

テンプレートと詳細な実例

テンプレートライブラリの全体と詳細な実例は references/details.md にあります。具体的なテンプレートが必要な場合はそのファイルを参照してください。

ベストプラクティス

推奨事項
  • 重みは経験的に調整する - 自分のデータでテストする
  • シンプルさのために RRF を使う - 調整なしでもうまく機能する
  • 再ランクを追加する - 品質が大幅に向上する
  • 両方のスコアをログに記録する - デバッグに役立つ
  • A/B テストを行う - 実際のユーザーへの影響を測定する
非推奨事項
  • 万能な設定があると決めつけない - クエリごとに異なる重みが必要
  • キーワード検索を省略しない - 完全一致をより適切に処理する
  • 過剰に取得しない - 再現率とレイテンシのバランスを取る
  • エッジケースを無視しない - 空の結果、単一単語のクエリ

コメント